# Jerat Tersembunyi

Tidak ada yang salah dengan ini. Ini adalah perilaku yang lebih baik dipelajari dari dokumentasi daripada dari analisis jawaban orang lain.

## Dalam respons ada field berlebih `_footer`

Paket gratis dan **setiap** panggilan tanpa kunci mendapatkan field tambahan `_footer` dengan tanda tangan di dalam body. Kunci berbayar tidak melihatnya. Jika parser kamu ketat terhadap field berlebih, ini hal pertama yang akan ditemuinya.

## Panggilan berulang yang sama tidak dikenakan biaya

Permintaan identik selama jendela cache mengembalikan `X-Cache: HIT`, dan panggilan seperti itu **tidak mengurangi kredit**: di respons `X-Credits-Used: 0`, dan sisa kredit dikembalikan. Jadi mengukur biaya dengan mengirimkan permintaan yang sama berulang kali tidak mungkin: kamu hanya membayar sekali.

## Kunci sandbox tidak menghabiskan apa pun

`aw_test_*` tidak mengurangi kredit sama sekali dan tidak masuk dalam limit akun. Ini bukan “kuota kecil”, ini nol. Sebaiknya kamu mengembangkan di atasnya, dan gunakan `aw_live_*` hanya saat memeriksa penagihan.

## Field yang tidak dikenal dilewati secara diam-diam

Body menerima key tambahan dan mengabaikannya. Pengecualian hanya untuk penulisan singkat yang secara eksplisit ditolak (`lat`, `tz` dan lainnya, lihat [Format bidang](/agent-setup/field-formats/)). Jadi typo pada nama field biasanya tidak akan terlihat: kamu akan mendapatkan `200` dan peta yang dihitung tanpa parametermu.

<Aside type="caution">
Kasus termahal dari jenis ini: `city` tampak seperti alamat, tapi tidak melakukan geocode apa pun. Tanpa `latitude` dan `longitude` tidak akan ada peta.
</Aside>

## Di atas lingkar kutub sistem rumah diganti

Untuk sistem kuadran ketika `|latitude| > 66.5°` Swiss Ephemeris secara diam-diam mengembalikan Porphyry. Kami tidak menyembunyikannya: di respons muncul field `warning`. Whole Sign dan Equal berfungsi pada semua lintang.

Kasus serupa kami tutup dengan penolakan: kode `houseSystem` yang tidak dikenal tidak lagi memberikan Placidus dengan nama lain, melainkan mengembalikan `400`.

## Kunci memiliki tiga batas independen

Kunci browser `pk_` dan kunci rahasia `aw_` dapat memiliki tiga pembatas sekaligus, dan mereka tidak saling menggantikan:

| Batas | Apa yang dikatakan | Penolakan |
|---|---|---|
| daftar domain | dari mana dapat dipanggil | `403 ORIGIN_REQUIRED` / `ORIGIN_NOT_ALLOWED` |
| `credits_cap_cycle` | berapa banyak kunci ini dapat menghabiskan | `429 KEY_BUDGET_EXHAUSTED` |
| `allowed_endpoints` | apa yang sebenarnya dapat dipanggil | `403 ENDPOINT_NOT_IN_SCOPE` |

Area endpoint **tidak** membebaskan pembacaan layanan: kunci yang dibatasi ke `embed/*` tidak akan membaca statistik milikmu juga. Ini sengaja, detailnya ada di [Autentikasi](/authentication/).

## Perubahan kunci berlaku mulai permintaan berikutnya

Kunci di-cache selama 60 detik, tapi setiap perubahan melalui `PATCH /v1/keys/{id}` menghapus cache secara langsung. Tidak perlu menunggu satu menit.