Erreurs courantes

Cette page est construite à partir de la répartition des statuts en production sur 30 jours. Là où nous ne mesurons pas quelque chose, c’est écrit tel quel.

Note

Nous n’écrivons pas les codes d’erreur dans le journal des requêtes, seulement les statuts HTTP. Tu trouveras donc ci-dessous la fréquence des statuts, mais pas de classement de codes comme INVALID_FIELD. Nous n’avons pas voulu l’inventer.

Erreurs de chemin

Les 4xx les plus fréquents du journal sont des 404, et presque aucun ne vient de toi : ce sont des scanners qui essaient .env, .git/config, wordpress/, wp-content/…. Les vraies erreurs de chemin des intégrateurs sont différentes, et elles sont déjà décrites avec des exemples ici : Les appels erronés que nous voyons le plus souvent. En bref : /api/… au lieu de /v1/…, un /v1/v1/… doublé, /swagger.json au lieu de /v1/openapi.json.

402 : le plan n’inclut pas l’endpoint

385 réponses en 30 jours. La répartition montre où le plan gratuit bloque le plus souvent :

Endpoint	402 en 30 jours
chart	114
transit-calendar	101
vedic/dashas/vimshottari/maha	48
ingresses	25
planetary-hours	24
vedic/panchang/full	24
eclipses	13

Le corps de la réponse contient current_plan et upgrade_to. Ce n’est pas une erreur de requête : le corps est correct, la clé est valide, simplement le plan n’inclut pas cet endpoint.

429 : deux limites différentes

6 791 réponses en 30 jours, dont 3 769 sans clé et 3 022 avec clé. Ce sont deux mécanismes différents, et il ne faut pas les confondre :

• sans clé, la limite est comptée par IP : 30 requêtes par heure. Le plus gros bloc de notre journal ne vient même pas des intégrateurs, mais d’un audit synthétique Chrome-Lighthouse depuis 15 adresses ;
• avec clé, la limite est le RPM de ton plan. La réponse contient Retry-After en secondes, et c’est ce délai qu’il faut attendre au lieu de relancer immédiatement.

400 : presque toujours le corps d’une requête de thème

700 réponses en 30 jours, concentrées sur les endpoints qui acceptent une date, une heure et des coordonnées : chart (111), horoscope/daily (19), transits (18), synastry (15), rectification (15).

La plus coûteuse de ces erreurs n’est même pas celle qui renvoie 400, mais celle qui renvoyait autrefois 200 : les écritures abrégées des champs. Règles et exemple de réponse : Formats des champs.

401 et 403

401, c’est une clé absente ou invalide ; le message nomme les deux classes, aw_ et pk_. 403, c’est l’origine : une clé navigateur pk_ est refusée si la requête arrive sans origine ou depuis un domaine étranger, et une clé limitée à certains endpoints répond ENDPOINT_NOT_IN_SCOPE et liste son périmètre dans details.

Tableau complet des codes : Erreurs.