更新日志
值得关注的平台与 API 变更,最新在前。要跟踪机器可读的规范版本,
请关注 /openapi.json 里的 OpenAPI
info.version —— 它为开发者 API 的每一个已发布版本打上戳记。
破坏性变更会被显式标出,并附带迁移说明。增量变更(新端点、新的可选字段、 新的响应头)不算破坏性 —— 请把客户端写成能容忍未知字段的,这样接口范围 扩大时它们仍能继续工作。
如何跟踪变更
- 规范版本 ——
info.version(带日期戳,例如2026-06-17),开发者 API 接口范围变化时递增。对规范做 diff 就能准确看出改了什么。 - 发现 ——
/.well-known/oauth-authorization-server反映当前的 OAuth 端点集合;请读取它,而不要把 URL 写死。 - 本页 —— 对值得知晓的变更给出的人类可读摘要,现已建立,并随平台演进 持续增补。
近期变更
API 规范 2026-06-17
- 应用版本管理端点已发布。
POST/GET /developer/clients/{clientId}/versions(以及审核人员端点) 现已进入 OpenAPI 规范 —— 提交整个应用的配置快照送审,而不是就地编辑 一个线上客户端。参见 应用版本管理。
更早的版本奠定了核心接口范围:OAuth 2.0 + PKCE 及 refresh / revoke / introspect、OpenID Connect、动态客户端注册、受权限范围管控的 数据 API(配方 / 基因 / 复用)、配方创建 + 发布、webhook,以及 已连接应用和开发者计划相关端点。