錯誤代碼說明-身份驗證類
除了 POST /v1/mcp/tools/discover 之外,所有端點都需要在 header 帶入 Authorization: Bearer <key>,驗證失敗時回傳本頁的錯誤代碼。回應格式見 例外狀況處理。
驗證方式分為兩種:
-
一般端點:使用 API Key(以
sk-開頭) -
API Key 管理端點(
/v1/api-keys):只接受 Admin Secret,不接受一般 API Key。Admin Secret 沒有到期日,因此這些端點不會回傳AUTH_003
AUTH 身份驗證類
| Error Code | HTTP Status | Scenario | Error Message |
|---|---|---|---|
AUTH_001 | 401 | 缺少 Authorization header,或 header 不是 Bearer <key> 格式 | Authorization header missing. |
AUTH_002 | 403 | API Key 無效:查無此 API Key,或與已發行的 API Key 不符;呼叫 /v1/api-keys 時則是 Admin Secret 不正確 | Invalid authorization key. |
AUTH_003 | 403 | API Key 已過期(目前時間已超過 expires_at)。透過「更新 / 停用 / 啟用 API Key」API 停用的 API Key 也會回傳此代碼 | API key has expired. |
API_KEY API Key 管理類
以下錯誤代碼屬於 API Key 資源管理,與上方的身份驗證錯誤性質不同,暫列於本頁。
| Error Code | HTTP Status | Scenario | Error Message |
|---|---|---|---|
API_KEY_001 | 404 | PATCH /v1/api-keys/{id} 指定的 API Key id 不存在 | API key not found. |