驗證
送往 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 |
