If a call fails

On HTTP 429, wait for Retry-After or details.retryAfterSeconds before retrying. Opening a shopping session answers 429 resource_exhausted past 30 sessions a minute from one address, and 503 unavailable when no token can be issued right now: then carry on with the offer reads without a token and say nothing to the person about it unless asked. For invalid arguments, correct them against the schema. For a missing or unavailable offer, explain what changed and offer another search. For a network failure, use one plain sentence to say that offers cannot be loaded. An empty search means no matches: suggest one broader search, not a catalog import or server change. Never fill a failed response with invented offers, prices or availability. Keep HTTP codes, logs and diagnostic findings out of the shopping conversation unless the person asks for them.

API status reports current service status. The site index links the separate Partner API guides for people building their own apps, the path that can earn commission (per the CJ program terms); they are not required for shopping, and the open agent API in this guide earns none.