访问权限与资源 ID
本页内容
为接入程序选择合适的认证方式,只授予完成业务需要的动作和自有应用范围。本指南同时解释 API 应用与业务应用,以及常见资源 ID。
选择认证方式
| 方式 | 适用场景 | 接入说明 |
|---|---|---|
| 长期 AccessKey(AKP) | 自己的服务端、定时任务和后端集成 | 按 CS1 签名调用,只能使用已经授予的能力。 |
| 临时 AccessKey(AKT) | 向另一个服务交付一个应用的限时只读查询 | 同时使用 ID、Secret 和安全令牌,详见临时凭据。 |
| OAuth Bearer | 第三方网页、Vue 和移动端 | 由用户选择应用并同意权限,详见OAuth 接入。 |
网站登录 Cookie 不能代替 API 凭据。沙箱 AKS 仅用于模拟环境;公开下载页面是否允许访问,按发布者的下载设置执行。
辨认应用与资源 ID
API 应用代表接入程序,业务应用代表要管理的企业签名或分发应用。请保存接口返回的完整 ID,不使用列表中的截短显示值。
| ID | 从哪里取得 | 用来做什么 |
|---|---|---|
| API 应用 ID | 开发者中心 | 管理这套程序的授权、凭据、预算和通知。 |
| 应用 ID(A 开头) | 应用列表或应用创建响应 | 指定要管理的业务应用。 |
| 版本 ID(V 开头) | 上传成功、版本列表或签名任务结果 | 指定签名输入、下载或发布版本。 |
| 上传任务 ID(U 开头) | 创建上传任务响应 | 确认分片、提交校验及恢复原上传。 |
| 签名任务 ID(J 开头) | 提交签名响应 | 查询该任务状态及准确产物。 |
| 报价 ID / 订单 ID | 报价和付款回执 | 分别查询报价或处理原订单,不能互换。 |
| revision / cursor | 对应读取接口 | 原样带回,用于并发检查或继续分页。 |
具体前缀与格式见接口字段约束。原包和签名包有各自的版本 ID,下载签名结果使用该任务返回的 signed_version.id。
相同前缀也可能用于不同业务。例如密钥核销回执与 Webhook 事件都可能使用 E 开头的标识;它们由不同接口返回,不能互换。请同时保存资源类型、业务应用与完整 ID,按照取得该 ID 的接口说明使用。
按任务配置权限
- 选择实际需要的业务,例如只查询应用、上传新版本或确认付款。
- 在开发者中心为 API 应用勾选相应动作,限定到自己的应用范围。创建新应用时,范围需要覆盖未来创建的自有应用。
- 按功能要求配置来源 IP、有效期和预算,并完成对应业务接入申请。
读取权限不包含写入权限。比如 billing:ReadOrders 只用于查订单,不能付款;列出证书不包含选择证书权限。所有权限仍受当前用户本人业务能力约束。
验证授权结果
调用 查询当前身份与权限核对当前账号、动作和资源范围,再查询一个已授权应用。没有权限或应用不属于当前账号时,接口可能返回 403 或 404,不应通过更换 ID 反复尝试。