> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 回應訊息碼

> status.code 的所有可能值、代表意義與處理建議。

HTTP 狀態碼固定為 `200`，請以回應中的 `status.code` 判斷結果。需要聯絡我方時，請一併提供回應中的 `status.traceCode`，方便追查。

## 共通訊息碼

所有 API 都可能回傳以下代碼：

| 代碼 | 說明 | 處理建議 |
| - | - | - |
| `0` | 成功 | — |
| `101` | 請求設定錯誤，例如網址路徑不存在、HTTP 方法錯誤、`Content-Type` 不是 `multipart/form-data`，或 `Authorization` 無效 | 確認請求網址、方法與 Header，請參考[請求與回應格式](https://doc.va777.net/zh-Hant/v2/guides/request-format.md)。 |
| `102` | 簽章錯誤 | 依[簽章規則](https://doc.va777.net/zh-Hant/v2/guides/signature.md)的「簽章錯誤排查」逐項檢查。 |
| `104` | 系統維護中 | 維護結束後再重新呼叫。 |
| `105` | 來源 IP 不在白名單內 | 將呼叫 API 的伺服器 IP 提供給我方加入白名單。 |
| `201` | 參數錯誤，例如缺少必填參數或格式不符 | 依 `status.message` 的說明修正參數。 |
| `999` | 系統異常 | 請提供 `status.traceCode` 聯絡我方。 |

## API 專屬訊息碼

以下代碼只有部分 API 會回傳，各 API 頁面的「回應訊息碼」會列出該 API 可能回傳的代碼。

| 代碼 | 說明 | 處理建議 |
| - | - | - |
| `103` | 我方處理失敗 | 稍後重試；持續發生時，請提供 `status.traceCode` 聯絡我方。 |
| `106` | 處理逾時 | 請提供 `status.traceCode` 聯絡我方確認處理結果。 |
| `202` | 帳號已存在（同一渠道下已有相同帳號） | 改用其他帳號，或直接使用既有帳號。 |
| `203` | 交易代碼重複 | 每筆交易請使用唯一的 `transactionID`。 |
| `204` | 餘額不足 | 確認會員錢包餘額後再操作。 |
| `205` | 帳號不存在 | 先[創建會員](https://doc.va777.net/zh-Hant/v2/api-reference/member/create.md)，並確認 `channelID`、`account` 是否正確（帳號區分大小寫）。 |
| `206` | 遊戲不存在 | 以[取得遊戲列表](https://doc.va777.net/zh-Hant/v2/api-reference/game/list.md)確認遊戲編號。 |
| `207` | 錢包處理異常 | 依 `status.message` 確認原因；持續發生時，請提供 `status.traceCode` 聯絡我方。 |
| `429` | 呼叫過於頻繁（僅有呼叫次數限制的 API 會回傳） | 降低呼叫頻率後重試，限制請見各 API 說明。 |
| `602` | 查無注單 | 確認注單編號與查詢條件。 |
| `800` | 風控異常，會員帳號可能已被鎖定 | 請提供 `status.traceCode` 聯絡我方客服。 |

## 免費旋轉訊息碼

| 代碼 | 說明 | 處理建議 |
| - | - | - |
| `416` | 查無此活動，或活動已取消、尚未開始、已過期 | 以[取得免費旋轉活動列表](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/event-list.md)確認活動狀態。 |
| `417` | 活動已達綁定人數上限 | — |
| `418` | 會員不在此活動中 | 確認會員是否已綁定此活動。 |
| `419` | 活動編號重複 | — |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.