回應訊息碼 - VA Docs

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

共通訊息碼

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

代碼	說明	處理建議
`0`	成功	—
`101`	請求設定錯誤，例如網址路徑不存在、HTTP 方法錯誤、`Content-Type` 不是 `multipart/form-data`，或 `Authorization` 無效	確認請求網址、方法與 Header，請參考請求與回應格式。
`102`	簽章錯誤	依簽章規則的「簽章錯誤排查」逐項檢查。
`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`	帳號不存在	先創建會員，並確認 `channelID`、`account` 是否正確（帳號區分大小寫）。
`206`	遊戲不存在	以取得遊戲列表確認遊戲編號。
`207`	錢包處理異常	依 `status.message` 確認原因；持續發生時，請提供 `status.traceCode` 聯絡我方。
`429`	呼叫過於頻繁（僅有呼叫次數限制的 API 會回傳）	降低呼叫頻率後重試，限制請見各 API 說明。
`602`	查無注單	確認注單編號與查詢條件。
`800`	風控異常，會員帳號可能已被鎖定	請提供 `status.traceCode` 聯絡我方客服。

免費旋轉訊息碼

代碼	說明	處理建議
`416`	查無此活動，或活動已取消、尚未開始、已過期	以取得免費旋轉活動列表確認活動狀態。
`417`	活動已達綁定人數上限	—
`418`	會員不在此活動中	確認會員是否已綁定此活動。
`419`	活動編號重複	—