📡 API Overview
This is the detailed API reference used by the product Quick Start and public
English /
中文 API overview pages. Live catalog responses and actual order fields remain authoritative.
All public API endpoints require X-Api-Key; query-string keys are rejected. Buy also requires Idempotency-Key. Poll SMS no faster than every 5 seconds, then back off to 10–15 seconds after empty results.
Errors use {success:false,error:{code,message,request_id}}. Handle HTTP 400, 401, 403, 404, 409, 429 (respect Retry-After), and 500. Stable codes include VALIDATION_ERROR, IDEMPOTENCY_REQUIRED, IDEMPOTENCY_CONFLICT, PURCHASE_IN_PROGRESS, ITEM_NOT_FOUND, ITEM_EXPIRED, RATE_LIMITED, PROVIDER_UNAVAILABLE, and INTERNAL_ERROR.