认证
发往 Platform API 的每个请求都需要两个请求头。
| 请求头 | 必填 | 用途 |
|---|---|---|
API-Key | ✅ | 在开发者控制台签发的 API 密钥 |
X-TenantID | ✅ | 请求所属的组织(工作区)ID |
bash
curl "$ME_BASE/voice/providers" \
-H "API-Key: $ME_API_KEY" \
-H "X-TenantID: $ME_TENANT"凭据只应保存在服务端
API-Key 是机密信息。不要嵌入浏览器、移动应用或任何你无法掌控的客户端,请通过自有后端转发请求。
密钥能访问的范围
密钥携带的是其所有者的权限。请求会以密钥所有者的身份、针对 X-TenantID 指定的组织进行授权。也就是说,密钥能访问的范围与所有者相同,不会更多。
密钥本身并不会收窄权限。请使用权限恰好够用的账号签发密钥;一旦泄露,立即重新签发。
错误
| 状态码 | 含义 | 处理 |
|---|---|---|
401 | API-Key 或 X-TenantID 缺失或无效 | 确认两个请求头都存在且有效 |
400 | 请求体格式有误 | 对照 API 参考 校验 |
404 | 找不到目标 | 检查路径与 ID |
