Errors
Messages are stable English text; programs should branch on code, not message.
Error envelope#
{"error":{"code":"INVALID_API_KEY","message":"...","request_id":"...","details":{}}}
Codes#
Stable codes: INVALID_REQUEST 400 · INVALID_API_KEY 401 · API_DAILY_LIMIT_REACHED 429 · INSUFFICIENT_SCOPE 403 · RESOURCE_NOT_FOUND 404 · IDEMPOTENCY_CONFLICT 409 · CURSOR_EXPIRED 410 · RATE_LIMITED 429 · INTERNAL_ERROR 500 · SERVICE_UNAVAILABLE/DATA_STALE 503.
Billing behavior#
All operations cost 0 credits. There is no monthly credit grant or commercial credit deduction.
API_DAILY_LIMIT_REACHED returns HTTP 429 after 10 REST data calls. Wait until 00:00 Asia/Shanghai; creating or rotating a key does not reset the account allowance.