# 版本与变更记录

## 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 凭证拒绝、超限调用日志采样。

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

## v1 · 2026-09-25

初始版本开放：

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

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

文档描述 v1 的实现协议。生产发布状态与域名可用性以实际接口响应为准；可先访问 [健康接口](https://api.screenshare.cn/v1/health)。