您在调用本产品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)#

需要帮助?#