Capcane
Nimic din acest lucru nu este o eroare. Este o comportare despre care este mai bine să afli din documentație, nu din analizarea unui răspuns străin.
În răspuns există un câmp suplimentar _footer
Section titled “În răspuns există un câmp suplimentar _footer”Planul gratuit și orice apel fără cheie primesc în corp un câmp suplimentar _footer cu o semnătură. Cheile plătite nu îl văd. Dacă parserul tău este strict la câmpurile suplimentare, acesta va fi primul lucru care îl va bloca.
Același apel repetat costă zero
Section titled “Același apel repetat costă zero”Un apel identic în timpul ferestrei de cache returnează X-Cache: HIT, și un astfel de apel nu deduce credite: în răspuns X-Credits-Used: 0, iar soldul este returnat. Adică nu poți măsura costul, rulând același apel de mai multe ori: plătești o singură dată.
Cheia Sandbox nu cheltuie nimic
Section titled “Cheia Sandbox nu cheltuie nimic”aw_test_* nu deduce credite deloc și nu intră în limita contului. Nu este o “cotă mică”, ci zero. Ar trebui să dezvolți exact pe ea, iar aw_live_* să o folosești doar când verifici facturarea.
Câmpurile necunoscute trec neobservate
Section titled “Câmpurile necunoscute trec neobservate”Corpul acceptă chei suplimentare și le ignoră. Excepție sunt doar abrevierile scurt explicit respinse (lat, tz și restul, vezi Formate de câmpuri). Deci o greșeală de scriere în numele unui câmp de obicei nu va fi observată: vei primi 200 și o hartă calculată fără parametrul tău.
Peste cercul polar, sistemul case este înlocuit
Section titled “Peste cercul polar, sistemul case este înlocuit”Pentru sistemele cuadrante la |latitude| > 66.5°, Swiss Ephemeris returnează în mod tăcut Porphyry. Nu ascundem acest lucru: în răspuns apare un câmp warning. Whole Sign și Equal funcționează la orice latitudine.
Cazul aferent l-am închis prin respingere: codul necunoscut houseSystem nu mai oferă Placidus sub un alt nume, ci returnează 400.
Cheia are trei limite independente
Section titled “Cheia are trei limite independente”Cheia de browser pk_ și cea secretă aw_ pot purta trei restricții simultan, și nu se înlocuiesc una pe alta:
| Limită | Ce spune | Refuz |
|---|---|---|
| listă domenii | de unde se poate apela | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | cât mult poate cheltui această cheie | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | exact ce se poate apela | 403 ENDPOINT_NOT_IN_SCOPE |
Domeniul endpoint nu eliberează citirile de serviciu: cheia restrânsă la embed/* nu va citi nici statisticile proprii. Acest lucru este intenționat, detalii în Autentificare.
Modificarea cheii intră în vigoare de la următorul apel
Section titled “Modificarea cheii intră în vigoare de la următorul apel”Cheile sunt cache-ate pentru 60 de secunde, dar orice modificare prin PATCH /v1/keys/{id} resetează cache-ul imediat. Nu trebuie să aștepți un minut.