Capcane
Niciuna dintre acestea nu este o eroare. Aceasta este un comportament despre care este mai bine să știi din documentație, decât să-l deducem din răspunsul altcuiva.
În răspuns există un câmp suplimentar _footer
Section titled “În răspuns există un câmp suplimentar _footer”Tariful gratuit și orice apel fără cheie primesc în corp un câmp suplimentar _footer cu semnătură. Cheile plătite nu îl văd. Dacă parser-ul tău este strict față de câmpurile suplimentare, acesta va eșua la primul pas.
Un apel identic repetat costă zero
Section titled “Un apel identic repetat costă zero”O cerere identică în timpul ferestrei de cache returnează X-Cache: HIT, iar un astfel de apel nu consumă credite: în răspuns X-Credits-Used: 0, iar restul se întoarce. Adică nu vei putea măsura costul, trimițând același apel în repetate rânduri: plătești doar o dată.
Cheia Sandbox nu consumă nimic
Section titled “Cheia Sandbox nu consumă nimic”aw_test_* nu consumă credite deloc și nu intră în limita contului. Aceasta nu este o “mică cotă”, ci zero. Dezvoltarea trebuie făcută pe această cheie, iar aw_live_* trebuie folosită doar când verifici facturarea.
Câmpurile necunoscute trec în tăcere
Section titled “Câmpurile necunoscute trec în tăcere”Corpul acceptă chei suplimentare și le ignoră. Excepție doar pentru scrieri scurte explicit respinse (lat, tz și altele, vezi Formatele câmpurilor). Astfel, o greșeală de ortografie în numele câmpului nu va fi observată: vei primi 200 și o hartă, calculată fără parametrul tău.
Sistemul de case este înlocuit în zona polară
Section titled “Sistemul de case este înlocuit în zona polară”Pentru sistemele de cadrant, dacă |latitude| > 66.5°, cuspidele sunt calculate ca Porphyry, deoarece aceste sisteme nu sunt definite acolo. Nu ascundem acest lucru: în răspuns apare câmpul warning. Whole Sign și Equal funcționează la orice latitudine.
Un caz similar l-am închis cu refuz: codul necunoscut houseSystem nu mai oferă Placidus sub o altă denumire, ci returnează 400.
Cheia are trei limite independente
Section titled “Cheia are trei limite independente”Cheia pentru browser pk_ și cea secretă aw_ pot avea trei limite simultan, și acestea nu se înlocuiesc reciproc:
| Limită | Ce spune | Refuz |
|---|---|---|
| Lista domeniilor | De unde poți face apeluri | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | Cât poate consuma această cheie | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | Ce poți apela exact | 403 ENDPOINT_NOT_IN_SCOPE |
Sfera endpoint-urilor nu eliberează citirile de serviciu: o cheie restrânsă la embed/* nu va citi nici statistica proprie. Aceasta este intenționată, detaliile în Autentificare.
Actualizarea cheii intră în vigoare de la următorul apel
Section titled “Actualizarea cheii intră în vigoare de la următorul apel”Cheile sunt cache-uite timp de 60 de secunde, dar orice schimbare prin PATCH /v1/keys/{id} resetează cache-ul imediat. Nu trebuie să aștepți o minută.