您在調用本產品 API 時，可能會遇到以下響應碼。以下列出了相關錯誤的原因及其解決方法。

HTTP 協議 CODE

code	msg	解釋	解決方案
0	Success	正常獲取到數據
40301	Invalid app_id	app_id 不存在	檢查控制台的 app_id
40302	Unauthorized API	接口未授權	聯絡商務開通 API 權限
40303	Invalid Secret	app_secret 錯誤	檢查 app_secret
40304	IP Restricted	IP 未授權	在控制台添加 IP 白名單
40001	Invalid Parameter	參數錯誤	參數格式/值錯誤
40002	Missing Parameter	缺少參數	缺少必填參數
40404	Invalid Path	路徑錯誤	檢查 API 文檔
42901	API Rate Limited	接口請求速率達到上限	請遵守接口級速率限制，降低頻率或升級產品
42902	Global Rate Limit	全局請求速率達到上限	全局速率限制，優化調用策略或升級產品
60000	Network Error	系統網絡異常	請稍後重試或緊急聯絡我們
60001	Timeout	網絡超時	等待 1 分鐘後重試、檢查本地網絡或聯絡我們

WebSocket 協議錯誤碼

本文檔描述了您在使用我們的 API 建立 WebSocket 連接時可能會遇到的錯誤響應。每個錯誤都包含一個 HTTP 狀態碼及一條描述性消息，幫助您識別和解決連接問題。

身份驗證錯誤

缺少參數 (400)

{
    "error": "Missing required parameters: app_id, app_secret"
}

確保在 WebSocket 連接請求中同時提供 app_id 和 app_secret

這些參數必須包含在連接 URL 或標頭中

無效身份驗證 (401)

{
    "error": "Invalid app_secret"
}

提供的 app_secret 與您的 app_id 不匹配

請確認您使用的是正確的密碼

訪問控制錯誤

路徑錯誤 (403)

{
    "error": "Path not accessible"
}

您的帳戶無權限訪問此路徑

如有問題可聯絡商務進行核對

IP 限制 (403)

{
    "error": "IP not allowed"
}

您的 IP 地址不在白名單中

可在您的控制台檢查是否已將訪問 IP 配置進白名單

運動 ID 相關錯誤

格式無效 (400)

{
    "error": "Invalid sport_id"
}

提供的 sport_id 格式不正確

請檢查 sport_id 格式是否有誤

權限問題 (403)

{
    "error": "Sport ID not accessible"
}

您的帳戶無權限訪問所請求的 sport_id

檢查您的訂閱套餐或聯絡商務開通訪問權限

重複訂閱 (403)

{
    "error": "Duplicate sport subscription from same IP"
}

您的 IP 地址已有一個針對此 sport_id 的 WebSocket 連接

同一個 IP 地址，每個運動只能連接一次

需要幫助？

如果您繼續遇到 WebSocket 連接問題或需要對任何錯誤消息進行澄清，請提供您的 app_id 和收到的錯誤消息，並聯絡商務團隊。

CODE 及錯誤碼

HTTP 協議 CODE#

WebSocket 協議錯誤碼#

身份驗證錯誤#

缺少參數 (400)#

無效身份驗證 (401)#

訪問控制錯誤#

路徑錯誤 (403)#

IP 限制 (403)#

運動 ID 相關錯誤#

格式無效 (400)#

權限問題 (403)#

重複訂閱 (403)#

需要幫助？#