Rekap dan Latihan

Poin-poin utama

• Sebuah API adalah daftar menu permintaan yang ditawarkan satu program ke program lain, dan itu adalah sebuah kontrak: bertanya dengan cara yang disepakati, dapatkan jawaban dalam bentuk yang disepakati. Kebanyakan bug API terjadi karena salah satu pihak melanggar kontrak itu.
• JSON adalah cara jawaban itu kembali — key dan value, dibangun dari object { } dan array [ ], yang bisa bersarang. Tipe datanya adalah string, number, boolean, null, array, object.
• Jebakan string-vs-number (42 vs "42") dan tidak-ada-vs-null adalah bug bentuk data yang paling umum. Kamu sekarang bisa membaca JSON — periksa tipenya saat sesuatu berperilaku aneh.
• Sebuah kunci API adalah kata sandi. Jangan pernah mengirimnya ke browser, jangan pernah meng-commit-nya ke git, simpan di environment variables. Kunci yang bocor harus segera dirotasi.
• Waspadai batas laju (429) dan penagihan bertarif ukur — loop buatan AI yang memanggil API berbayar tanpa jeda adalah cara kamu mendapat tagihan berdigit empat. Baca harganya dan atur peringatan anggaran lebih dulu.

Coba sendiri

Cari sebuah API gratis tanpa kunci di browsermu — misalnya buka https://api.github.com/users/octocat langsung di tab baru. Kamu akan melihat respons JSON mentah. Bacalah seperti sebuah formulir: kenali object-object { }, temukan sebuah array jika ada, dan sebutkan tipe dari tiga value yang berbeda (mana yang string? number? boolean? adakah yang null?). Kamu baru saja melakukan pengecekan kewarasan yang persis diminta bab ini untuk kamu jalankan pada setiap respons API yang dihubungkan AI.

Prompt bab ini

I'm calling an API and I want to check the data shape myself, as a beginner.
Here are the real docs (example request + example response):
<paste the example request and JSON response from the API's docs>

- Before writing parsing code, show me the raw JSON the call returns and
  point out the keys, their types, and anything that might be null or missing.
- Confirm the keys my code reads actually exist in that response.
- Make sure the API key is read from an environment variable on the server,
  never hardcoded or sent to the browser.
- Tell me what happens if the call fails, times out, or hits a rate limit.