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
Section titled “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
Section titled “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
Section titled “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
Section titled “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). Jadi typo pada nama field biasanya tidak akan terlihat: kamu akan mendapatkan 200 dan peta yang dihitung tanpa parametermu.
Di atas lingkar kutub sistem rumah diganti
Section titled “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
Section titled “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.
Perubahan kunci berlaku mulai permintaan berikutnya
Section titled “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.