开发者平台管理员
API Key 与公开 API
创建最小权限 API Key，并安全处理分页、限流与重试。
- 适用对象
- 管理员
- 指南深度
- 2 个步骤
- 内容审核
- 2026-07-22
完成后能获得什么
这里说明按指南操作后的实际结果，同时保留当前产品边界。
创建密钥并限制范围
泄露的密钥无法访问无关资源。
使用版本化契约
重试不会压垮服务或重复回复。
开始前
- 已启用“外部集成”的 Max 或 Enterprise 套餐
- 开发者集成管理权限
操作步骤
创建密钥并限制范围
复制仅显示一次的 aosk_ 密钥，只授予必要 scope，并限制团队或收件箱；写入客户资料需要租户级客户范围。
预期结果: 泄露的密钥无法访问无关资源。
使用版本化契约
向 /api/v1/external 发送 X-AOS-Api-Key。ID 为字符串，时间为 UTC ISO，游标分页默认 50、最多 100。读取限流头，429 后退避；消息重试使用稳定的 Idempotency-Key。OpenAPI 位于 /api/v1/external/openapi.json。
预期结果: 重试不会压垮服务或重复回复。