版本与变更记录

v1 永久密钥与文档标识更新 · 2026-09-25

• 个人和组织 API Key 新增“永久有效”，生成时无需再次输入账户密码或两步验证码。
• /v1/me 的 expires_at 支持 null，表示不自动到期；现有有期限密钥保持原期限。
• 永久密钥仍计入 20 把有效密钥上限，并遵守权限、撤销和防刷规则；一次性邀请仍为 7 天。
• 开发者文档页眉与浏览器图标统一使用 Undefined SS 社区 Logo。

v1 防刷保护更新 · 2026-09-25

• 新增来源 IP/凭证突发保护、跨密钥和管理员的组织共享配额、每日总量及邀请创建专项限制。
• 新增工单桥接并发限制、配置读取与凭证创建频率限制、Webhook 组织数量和测试/重发配额。
• 动态 Retry-After 与 X-RateLimit-* 响应头；限流设施异常时保护性返回 503。
• 有界请求体读取、未知/重复参数和 URL 凭证拒绝、超限调用日志采样。

接入程序应按请求与响应约定处理限流，不能依赖旧的固定 60 秒重试值。

v1 · 2026-09-25

初始版本开放：

• 个人及单组织 API Key，有限有效期、权限范围、撤销和调用日志。
• /v1/me 凭证检查与 /v1/health 健康接口。
• USS 公开记录精确查询、组织记录列表与详情。
• 组织一次性邀请创建、分页查询、状态、取回链接与撤销。
• 已加入组织工单列表和只读进度。
• 个人及组织服务权益汇总。
• 组织 Webhook，接收端验证、HMAC 签名、重试和手动重发。
• OpenAPI、完整 Markdown、AI 索引和可运行示例。

本版本不提供 OAuth 用户授权、公开模糊玩家搜索、工单正文和附件、自动结果写入、支付或成员管理。

文档描述 v1 的实现协议。生产发布状态与域名可用性以实际接口响应为准；可先访问 健康接口。