Error codes
Check both HTTP status and error.code. error.message has the detail.
| code | HTTP | When |
|---|---|---|
INVALID_INPUT | 400 | Bad body / missing fields |
UNAUTHORIZED | 401 | Missing or invalid API key |
NOT_FOUND | 404 | Unknown path or type |
INSUFFICIENT_BALANCE | 402 | Not enough points |
RATE_LIMITED | 429 | QPS / concurrency / daily cap |
TIMEOUT | 504 | Solve exceeded timeout |
SOLVE_FAILED | 502 | Vendor solve failed; see message |
INTERNAL | 500 | Unexpected error |
Common messages
| message | Meaning |
|---|---|
body must be a JSON object | Body is not an object |
timeout must be a positive number | Bad timeout |
url required | Missing valid url |
unknown solver: xxx | Bad type |
invalid api key | Auth failed |
insufficient points | Balance too low |
qps exceeded / concurrency exceeded / daily limit exceeded | Rate limited |
akamai timeout after 90000ms | Full solve timeout (type-prefixed) |