Pièges
Rien de tout cela n’est une erreur. C’est un comportement qu’il vaut mieux connaître dans la documentation plutôt que dans une réponse tierce.
Le champ supplémentaire _footer apparaît dans la réponse
Section intitulée « Le champ supplémentaire _footer apparaît dans la réponse »Le tarif gratuit et toute requête 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 parseur est strict sur les champs supplémentaires, c’est là qu’il échouera.
Une requête identique coûte zéro
Section intitulée « Une requête identique coûte zéro »Une requête identique dans la fenêtre de cache retourne X-Cache: HIT, et cette requête ne consomme pas de crédits : dans la réponse, X-Credits-Used: 0, et le solde est restitué. Ainsi, mesurer le coût en répétant la même requête ne fonctionnera pas : vous paierez une seule fois.
La clé de test ne consomme rien
Section intitulée « La clé de test ne consomme rien »aw_test_* ne consomme aucun crédit et ne compte pas dans la limite du compte. Ce n’est pas une “petite quotité”, c’est zéro. Il faut développer avec celle-ci, et utiliser aw_live_* uniquement 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. L’exception concerne uniquement les notations courtes explicitement rejetées (lat, tz et autres, voir Formats des champs). Ainsi, une faute de frappe dans le nom du champ ne se fera généralement pas remarquer : vous obtiendrez un 200 et une carte calculée sans votre paramètre.
Les systèmes de maisons sont remplacés au-delà du cercle polaire
Section intitulée « Les systèmes de maisons sont remplacés au-delà du cercle polaire »Pour les systèmes quadrants, si |latitude| > 66.5°, les cuspides sont comptées comme Porphyry, car ces systèmes ne sont pas définis là-bas. Nous ne le cachons pas : un champ warning apparaît dans la réponse. Whole Sign et Equal fonctionnent à toute latitude.
Nous avons fermé un cas voisin par une erreur : un code de système de maison inconnu ne donne plus Placidus sous un nom étranger, 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 simultanément, et elles ne se remplacent pas mutuellement :
| Limite | Que dit-elle | Rejet |
|---|---|---|
| Liste des domaines | D’où les appels sont autorisés | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | Combien cette clé peut dépenser | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | Quels appels sont autorisés | 403 ENDPOINT_NOT_IN_SCOPE |
La portée des endpoints ne libère pas les lectures de service : une clé restreinte à embed/* ne lira pas non plus ses propres statistiques. C’est intentionnel, les détails sont 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 le cache immédiatement. Il n’est pas nécessaire d’attendre une minute.