错误码

失败时同时看 HTTP 状态和 error.code。error.message 是具体原因。

code	HTTP	何时出现
INVALID_INPUT	400	body 不合法；缺必填字段；参数格式错误
UNAUTHORIZED	401	缺少或错误的 API Key
NOT_FOUND	404	路径不存在；未知或不支持的 type
INSUFFICIENT_BALANCE	402	点数不足
RATE_LIMITED	429	QPS / 并发 / 日限额超限
TIMEOUT	504	整次求解超过请求 timeout
SOLVE_FAILED	502	求解失败（目标页结构变化、脚本缺失等），细节在 message
INTERNAL	500	未预期异常。调用方只看到通用提示

常见 message

message	含义
body must be a JSON object	请求体不是对象
timeout must be a positive number	timeout 非法
url required	缺合法 url
unknown solver: xxx	type 不存在
invalid api key	鉴权失败
insufficient points	余额不够
qps exceeded / concurrency exceeded / daily limit exceeded	触发限流
akamai timeout after 90000ms	整次求解超时（前缀为 type）

厂商内部失败信息会出现在 SOLVE_FAILED 的 error.message 中，便于排查。