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