GeekNums开发者文档

错误码

失败响应为 HTTP 4xx/5xx,错误体中的 reason 是稳定契约,请据它判断,而非匹配 message 文本。

missing_api_credentials401
四个鉴权请求头缺失或格式不合法
确认四个头都已发送,且 nonce 长度在 16~64 之间
invalid_api_key401
密钥不存在、已删除,或账号不可用
在控制台确认密钥仍然有效
timestamp_expired401
时间戳超出 5 分钟窗口
同步机器时钟;注意单位是毫秒而非秒
nonce_replayed401
该 nonce 已被使用过
每个请求生成新的随机 nonce,不要复用整个请求头
invalid_signature401
签名不匹配
核对签名原文五段的顺序与内容,尤其 PATH 是否含 /api、query 是否原样计入
invalid_product400
产品 ID 不存在或未对你的账号开放
以 /products 返回的 ID 为准
insufficient_balance400
余额不足以支付本次任务
充值后重试
not_found404
任务不存在,或不属于当前账号
确认任务 ID 来自本账号——跨账号访问一律按不存在处理