Skryté úskalí
Nic z toho není chybou. Je to chování, o kterém je lepší se dozvědět z dokumentace než z analýzy cizí odpovědi.
V odpovědi je nadbytečné pole _footer
Sekce “V odpovědi je nadbytečné pole _footer”Bezplatný tarif a jakýkoli volání bez klíče dostávají v těle dodatečné pole _footer s podpisem. Placené klíče ho nevidí. Pokud je váš parser přísný na nadbytečná pole, tohle bude první, na čem zakopne.
Opakovaný stejný volání stojí nulu
Sekce “Opakovaný stejný volání stojí nulu”Identický požadavek během okna cache vrací X-Cache: HIT a takové volání neodečítá kredity: v odpovědi je X-Credits-Used: 0 a zůstatek se vrátí zpět. Takže nemůžete změřit cenu tím, že budete posílat stejný požadavek znovu a znovu: zaplatíte jednou.
Sandbox klíč nevyčerpává nic
Sekce “Sandbox klíč nevyčerpává nic”aw_test_* vůbec neodečítá kredity a nezapočítává se do limitu účtu. To není “malá kvóta”, to je nula. Měli byste na něm vyvíjet a aw_live_* použít až když kontrolujete fakturaci.
Neznámá pole projíždějí beze změn
Sekce “Neznámá pole projíždějí beze změn”Tělo přijímá nadbytečné klíče a ignoruje je. Výjimkou jsou pouze explicitně odmítnuté zkratky (lat, tz a zbytek, viz Formátů polí). Takže překlep v názvu pole obvykle nepoznáte: dostanete 200 a graf vypočtený bez vašeho parametru.
Nad polárním kruhem se systém domů nahrazuje
Sekce “Nad polárním kruhem se systém domů nahrazuje”Pro kvadrantní systémy při |latitude| > 66.5° jsou vrcholy počítány jako Porphyry, protože tyto systémy zde nejsou definovány. To necháváme skryté: v odpovědi se objeví pole warning. Whole Sign a Equal fungují na jakékoli zeměpisné šířce.
Sousední případ jsme uzavřeli odmítnutím: neznámý kód houseSystem už nevrací Placidus pod jiným názvem, ale vrací 400.
Klíč má tři nezávislé limity
Sekce “Klíč má tři nezávislé limity”Prohlížečový klíč pk_ a tajný aw_ mohou mít najednu tři omezení a nenahrazují se navzájem:
| Limit | Co říká | Odmítnutí |
|---|---|---|
| seznam domén | odkud lze volat | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | kolik tento klíč může utratit | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | co přesně lze volat | 403 ENDPOINT_NOT_IN_SCOPE |
Rozsah endpointů neuvolňuje servisní čtení: klíč omezený na embed/* nepřečte ani vlastní statistiky. Je to záměrné, podrobnosti v Autentizaci.
Úprava klíče se projeví od dalšího požadavku
Sekce “Úprava klíče se projeví od dalšího požadavku”Klíče se cachují po dobu 60 sekund, ale jakákoli změna přes PATCH /v1/keys/{id} okamžitě resetuje cache. Nemusíte čekat minutu.