Erreurs
Codes d'état HTTP et format du corps d'erreur renvoyés par l'API javinfo.
Les erreurs utilisent les codes d'état HTTP standard. Les requêtes échouées ne sont pas facturées — vous ne payez que pour les réponses 200 réussies.
Codes d'état
| État | Signification |
|---|---|
400 | Mauvaise requête — un /query vide (sans q ni filtre), un ID de fournisseur inconnu, ou une clé manquante sur une session qui devrait être authentifiée. |
401 | Clé API manquante ou invalide. |
402 | Solde insuffisant — rechargez votre compte. Voir facturation. |
404 | Aucun résultat trouvé (tous les fournisseurs ont échoué, ou index vide pour /random). |
422 | Aucun fournisseur ne peut satisfaire le filtre/tri demandé — ou un fournisseur épinglé ne le peut pas. Voir Filtrage. |
429 | Limite de débit ou quota quotidien dépassé. Réessayez après l'en-tête Retry-After. |
499 | Le client a fermé la requête avant qu'un fournisseur ne réponde. |
Corps d'erreur
Les erreurs renvoient un corps JSON avec un code lisible par machine et un message lisible par humain :
{
"code": "NOT_FOUND",
"message": "No result found for \"SSIS-999\"."
}Gestion du 429
Lorsque vous atteignez la limite de débit, patientez en utilisant l'en-tête de réponse Retry-After (secondes) :
if (res.status === 429) {
const wait = Number(res.headers.get('Retry-After') ?? 1);
await new Promise((r) => setTimeout(r, wait * 1000));
}