# 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`

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

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

`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

Corpul acceptă chei suplimentare și le ignoră. Excepție sunt doar abrevierile scurt explicit respinse (`lat`, `tz` și restul, vezi [Formate de câmpuri](/agent-setup/field-formats/)). 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.

<Aside type="caution">
Cel mai scump caz de acest gen: `city` pare o adresă, dar nu geocodifică nimic. Fără `latitude` și `longitude` nu va exista hartă.
</Aside>

## 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

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](/authentication/).

## 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.