跳至主要内容
版本:PrivStation 4.0.0
Markdown 原文

錯誤代碼說明-身份驗證類

除了 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 CodeHTTP StatusScenarioError Message
AUTH_001401缺少 Authorization header,或 header 不是 Bearer <key> 格式Authorization header missing.
AUTH_002403API Key 無效:查無此 API Key,或與已發行的 API Key 不符;呼叫 /v1/api-keys 時則是 Admin Secret 不正確Invalid authorization key.
AUTH_003403API Key 已過期(目前時間已超過 expires_at)。透過「更新 / 停用 / 啟用 API Key」API 停用的 API Key 也會回傳此代碼API key has expired.

API_KEY API Key 管理類​

以下錯誤代碼屬於 API Key 資源管理,與上方的身份驗證錯誤性質不同,暫列於本頁。

Error CodeHTTP StatusScenarioError Message
API_KEY_001404PATCH /v1/api-keys/{id} 指定的 API Key id 不存在API key not found.