错误码一览
| code | 含义 | 常见 msg | 建议处理方式 |
|---|---|---|---|
0 | 成功 | Ok | 正常读取 info 中的数据 |
400 | 参数错误 | missing params ... | 检查必填参数、参数名和参数格式 |
401 | 鉴权失败 | authentication error | 检查 client-id 和 access-key |
402 | 余额不足 | Insufficient account balance(renewal) | 充值或降低续费范围后重试 |
403 | 不可续费 | does not support renewal | 检查节点状态和续费资格 |
404 | 订单不存在 | order does not exist | 检查 trade_no 是否正确且属于当前账号 |
422 | 业务校验失败 | 天数或续费错误 | 检查续费天数、节点状态及产品规则 |
429 | 请求过于频繁 | request error | 降低请求频率，稍后重试 |
500 | 服务异常 | request error | 稍后重试；持续发生时联系支持团队 |
400：参数错误
请依次检查：
- 必填参数是否存在。
- 参数名的大小写和拼写是否正确。
- 多个节点 ID 是否使用英文逗号分隔。
page_no、page_limit和renew_days是否为有效整数。page_limit是否超过最大值100。
节点续费接口缺少节点参数时，msg 可能显示 missing params node_ids，但请求参数名应使用 node_id。
401：鉴权失败
请确认：
- 请求头同时包含
client-id和access-key。 - 凭证中没有多余空格、换行或引号。
client-id与access-key属于同一账号或接入环境。- 凭证仍然有效。
402：余额不足
该错误通常出现在节点续费时。请确认账号可用余额足以支付全部节点的续费费用，然后重新提交请求。
403：节点不可续费
一个或多个节点当前不支持续费。请检查节点状态、产品类型和有效期；如果无法确认原因，请将节点 ID 提供给 QuarkIP 支持团队。
404：订单不存在
检查 trade_no 是否完整、是否属于当前账号，以及请求使用的 API 域名是否正确。
422：业务校验失败
此错误通常表示请求格式正确，但续费天数、节点状态或其他业务条件不符合要求。请根据 msg 检查具体字段。
429：请求过于频繁
降低调用频率，并使用逐步增加等待时间的重试策略。不要在没有延迟的情况下连续重试。
500：服务异常
建议稍后重试。自动化程序可对偶发的 500 错误进行有限次数重试；如果错误持续出现，请联系 QuarkIP 支持团队。
联系支持团队前请准备
为便于快速定位问题，请提供：
- 请求时间及所在时区
- 接口路径和请求方法
- HTTP 状态码、响应体中的
code和msg - 相关的订单 ID 或节点 ID
- 可复现的请求参数（请隐藏
access-key、代理密码等敏感信息）
请勿发送完整 API Token 或代理密码。
