Pièges
Rien de tout cela n’est une erreur. C’est un comportement qu’il vaut mieux apprendre via la documentation plutôt qu’en analysant la réponse d’autrui.
La réponse contient un champ superflu _footer
Section intitulée « La réponse contient un champ superflu _footer »Le tarif gratuit et tout appel sans clé reçoivent un champ supplémentaire _footer avec une signature dans le corps. Les clés payantes ne le voient pas. Si votre analyseur est strict concernant les champs superflus, c’est là qu’il trébuchera en premier.
Un appel identique répété ne coûte rien
Section intitulée « Un appel identique répété ne coûte rien »Une requête identique pendant la fenêtre de cache renvoie X-Cache: HIT, et un tel appel ne débite pas de crédits : dans la réponse, X-Credits-Used: 0, et le solde est restitué. Autrement dit, il est impossible de mesurer le coût en faisant tourner la même requête : vous ne payez qu’une seule fois.
La clé Sandbox ne dépense rien
Section intitulée « La clé Sandbox ne dépense rien »aw_test_* ne débite pas de crédits du tout et n’est pas inclus dans la limite du compte. Ce n’est pas une «petite allocation», c’est zéro. Vous devriez développer avec cette clé, et prendre aw_live_* lorsque vous vérifiez la facturation.
Les champs inconnus sont ignorés silencieusement
Section intitulée « Les champs inconnus sont ignorés silencieusement »Le corps accepte les clés supplémentaires et les ignore. La seule exception est pour les abréviations explicitement rejetées (lat, tz et les autres, voir Formats de champs). Par conséquent, une faute de frappe dans le nom d’un champ ne sera généralement pas remarquée : vous obtiendrez un 200 et une carte calculée sans votre paramètre.
Au-delà du cercle polaire, le système de maisons est remplacé
Section intitulée « Au-delà du cercle polaire, le système de maisons est remplacé »Pour les systèmes quadrants lorsque |latitude| > 66.5°, Swiss Ephemeris renvoie silencieusement Porphyry. Nous ne le cachons pas : un champ warning apparaît dans la réponse. Whole Sign et Equal fonctionnent à n’importe quelle latitude.
Nous avons fermé le cas adjacent : un code houseSystem inconnu ne renvoie plus Placidus sous un autre nom, mais retourne 400.
La clé a trois limites indépendantes
Section intitulée « La clé a trois limites indépendantes »La clé de navigateur pk_ et la clé secrète aw_ peuvent porter trois restrictions à la fois, et elles ne se remplacent pas :
| Limite | Ce qui est dit | Refus |
|---|---|---|
| liste de domaines | d’où on peut appeler | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | combien cette clé peut dépenser | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | quoi on peut appeler exactement | 403 ENDPOINT_NOT_IN_SCOPE |
La portée des endpoints ne libère pas les lectures de service : une clé limitée à embed/* ne lira pas sa propre statistique. C’est intentionnel, détails dans Authentification.
La modification de la clé prend effet dès la requête suivante
Section intitulée « La modification de la clé prend effet dès la requête suivante »Les clés sont mises en cache pendant 60 secondes, mais toute modification via PATCH /v1/keys/{id} réinitialise immédiatement le cache. Il n’est pas nécessaire d’attendre une minute.