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

除了 `POST /v1/mcp/tools/discover` 之外，所有端點都需要在 header 帶入 `Authorization: Bearer <key>`，驗證失敗時回傳本頁的錯誤代碼。回應格式見 [例外狀況處理](https://privstation-docs.apmic.ai/latest/privai-400/例外狀況處理.md)。  
驗證方式分為兩種：

- **一般端點**：使用 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. |
