Skip to content

认证 ​

发往 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 指定的组织进行授权。也就是说,密钥能访问的范围与所有者相同,不会更多。

密钥本身并不会收窄权限。请使用权限恰好够用的账号签发密钥;一旦泄露,立即重新签发。

错误 ​

状态码含义处理
401API-Key 或 X-TenantID 缺失或无效确认两个请求头都存在且有效
400请求体格式有误对照 API 参考 校验
404找不到目标检查路径与 ID