Valkuilen
Niets hiervan is een fout. Het is gedrag waar je beter uit de documentatie over leert dan door het analyseren van een vreemd antwoord.
In het antwoord is er een extra veld _footer
Section titled “In het antwoord is er een extra veld _footer”Het gratis abonnement en elke aanroep zonder sleutel krijgen een extra veld _footer met een handtekening in de body. Betaalde sleutels zien dit niet. Als je parser streng is voor extra velden, is dit het eerste waarop het struikelt.
Identieke herhaling kost nul
Section titled “Identieke herhaling kost nul”Identieke aanroepen binnen het cachevenster geven X-Cache: HIT en zo’n aanroep trekt geen credits af: in het antwoord X-Credits-Used: 0, en het saldo wordt teruggestort. Je kunt dus de kosten niet meten door dezelfde aanroep herhaaldelijk te sturen: je betaalt één keer.
Sandbox-sleutel kost niets
Section titled “Sandbox-sleutel kost niets”aw_test_* trekt helemaal geen credits af en valt niet binnen de accountlimiet. Het is geen ‘kleine quota’, maar nul. Je moet hierop ontwikkelen, en aw_live_* gebruiken wanneer je de facturatie controleert.
Onbekende velden worden genegeerd
Section titled “Onbekende velden worden genegeerd”De body accepteert extra sleutels en negeert ze. De uitzondering is voor expliciet geweigerde korte notaties (lat, tz en de rest, zie Veldformaten). Een typefout in een veldnaam merk je meestal niet: je krijgt 200 en een kaart berekend zonder je parameter.
Boven de poolcirkel wordt het huizensysteem vervangen
Section titled “Boven de poolcirkel wordt het huizensysteem vervangen”Voor kwadrant systemen met |latitude| > 66.5° geeft Swiss Ephemeris stil Porphyry terug. We verbergen dit niet: in het antwoord verschijnt een warning veld. Whole Sign en Equal werken op elke breedtegraad.
Een vergelijkbaar geval hebben we gesloten met weigering: een onbekende houseSystem code geeft niet langer Placidus onder een andere naam, maar retourneert 400.
Sleutels hebben drie onafhankelijke limieten
Section titled “Sleutels hebben drie onafhankelijke limieten”De browser-sleutel pk_ en de geheime aw_ kunnen drie beperkingen tegelijk dragen, en ze vervangen elkaar niet:
| Limiet | Wat het zegt | Weigering |
|---|---|---|
| domeinlijst | waarvandaan je kunt aanroepen | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | hoeveel deze sleutel kan uitgeven | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | wat precies je kunt aanroepen | 403 ENDPOINT_NOT_IN_SCOPE |
Het endpoint-bereik vrijstelt niet voor service-lezingen: een sleutel beperkt tot embed/* leest ook zijn eigen statistiek niet. Dit is opzettelijk, details in Authenticatie.
Wijziging van een sleutel werkt vanaf de volgende aanroep
Section titled “Wijziging van een sleutel werkt vanaf de volgende aanroep”Sleutels worden 60 seconden gecached, maar elke wijziging via PATCH /v1/keys/{id} reset de cache onmiddellijk. Je hoeft niet een minuut te wachten.