Valkuilen
Niets hiervan is een fout. Het is gedrag waar je beter uit de documentatie kunt leren dan uit het analyseren van iemands antwoord.
In het antwoord is er een overbodig veld _footer
Section titled “In het antwoord is er een overbodig veld _footer”Het gratis tarief en elke oproep zonder sleutel krijgen in de body een extra veld _footer met een ondertekening. Betaalde sleutels zien dit niet. Als je parser streng is ten aanzien van overbodige velden, is dit het eerste waar hij tegenaan loopt.
Een herhaalde identieke oproep kost nul
Section titled “Een herhaalde identieke oproep kost nul”Een identieke aanvraag binnen het cache‑venster geeft X-Cache: HIT terug, en zo’n oproep trekt geen kredieten af: in het antwoord X-Credits-Used: 0, en het resterende saldo wordt teruggegeven. Je kunt de kosten niet meten door steeds dezelfde aanvraag te sturen: je betaalt één keer.
Sandbox‑sleutel verbruikt niets
Section titled “Sandbox‑sleutel verbruikt niets”aw_test_* trekt helemaal geen kredieten af en telt niet mee voor de account‑limiet. Het is geen “kleine quota”, het is nul. Ontwikkel vooral op deze, en gebruik aw_live_* pas wanneer je de facturering test.
Onbekende velden worden stilletjes geaccepteerd
Section titled “Onbekende velden worden stilletjes geaccepteerd”De body accepteert extra sleutels en negeert ze. Uitzondering geldt alleen voor duidelijk afgewezen korte notaties (lat, tz en andere, zie Formaten van velden). Daarom zal een typefout in een veldnaam meestal niet opvallen: je krijgt een 200 en een kaart berekend zonder jouw parameter.
Boven de poolcirkel wordt het huizen‑systeem vervangen
Section titled “Boven de poolcirkel wordt het huizen‑systeem vervangen”Voor kwadrant‑systemen bij |latitude| > 66.5° worden cusps berekend als Porphyry, omdat die systemen daar niet gedefinieerd zijn. We verbergen dit niet: in het antwoord verschijnt een veld warning. Whole Sign en Equal werken op elke breedtegraad.
Een naburig geval hebben we afgesloten met een fout: een onbekende code houseSystem geeft niet langer Placidus onder een andere naam, maar retourneert 400.
Een sleutel heeft drie onafhankelijke limieten
Section titled “Een sleutel heeft drie onafhankelijke limieten”De browser‑sleutel pk_ en de geheime aw_ kunnen tegelijk drie beperkingen hebben, en ze vervangen elkaar niet:
| Limiet | Wat het zegt | Afwijzing |
|---|---|---|
| lijst van domeinen | vanwaar je mag oproepen | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | hoeveel deze sleutel mag uitgeven | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | wat je precies mag oproepen | 403 ENDPOINT_NOT_IN_SCOPE |
Het bereik van endpoints vrijt geen service‑leesacties: een sleutel beperkt tot embed/* kan zelfs je eigen statistieken niet lezen. Dit is opzettelijk, details in Authenticatie.
Een sleutelwijziging treedt in werking bij de volgende aanvraag
Section titled “Een sleutelwijziging treedt in werking bij de volgende aanvraag”Sleutels worden 60 seconden gecached, maar elke wijziging via PATCH /v1/keys/{id} wist de cache meteen. Je hoeft geen minuut te wachten.