Skip to main content

​
HTTP errors

FastAPI errors generally return a JSON detail value. Validation errors can contain a list of field errors; do not assume detail is always a string.

​
Plan allowances

These are the current default allowances displayed by XAPI China. Check your dashboard and GET /v1/me for the active account allowance. Every plan exposes the same public data endpoints. Quotas and throttling are shared across all of an account’s keys; creating more keys does not increase the allowance. Each successful authenticated data call counts once, including search pages, count, models, details, images, similar listings, inspection, and insurance-event evidence. Public makes/filters and GET /v1/me do not consume data quota. Cached successful data requests still count.

​
Handle throttling

A per-minute 429 includes Retry-After. Delay according to the header instead of retrying immediately. A monthly-quota 429 requires quota renewal or a plan change; rapid retries will not resolve it. Use a shared request queue if multiple jobs or services use the same account. In the production guide, combine pacing with caching and bounded retries.