Documentation
Erreurs
Les erreurs HTTP ont un objet `error` avec `code`, `message` et, si pertinent, `parameter`.
Statuts et codes
| Statut | Code | Action |
|---|---|---|
| 400 | INVALID_QUERY | Corriger un paramètre mal formé, répété ou inconnu |
| 400 | CONFLICTING_FILTERS | Résoudre un conflit entre continent, nationalité ou ville |
| 400 | UNSUPPORTED_VALUE | Choisir un pays ou une ville pris en charge |
| 429 | RATE_LIMITED | Attendre la durée indiquée par Retry-After |
| 503 | RESPONSE_TOO_LARGE | Réduire count ou sélectionner moins de champs |
Gérer le quota
Le quota par défaut est de 30 requêtes par minute, par IP et par instance. Une réponse 429 inclut Retry-After en secondes. Attendez au moins cette durée avant de réessayer.
JS
if (response.status === 429) {
const seconds = Number(response.headers.get('Retry-After') ?? 1);
await new Promise((resolve) => setTimeout(resolve, seconds * 1000));
}Autres réponses
Une route inconnue renvoie 404 ; une méthode non prise en charge renvoie 405. Une réponse dépassant 256 Kio renvoie 503 avec RESPONSE_TOO_LARGE.