สรุปและแบบฝึกหัด

ประเด็นสำคัญ

คือเมนูของคำขอที่โปรแกรมหนึ่งเปิดให้อีกโปรแกรมหนึ่งสั่งได้ และมันคือ สัญญา: ถามในแบบที่ตกลงกันไว้ ได้คำตอบในรูปทรงที่ตกลงกันไว้ บั๊ก API ส่วนใหญ่เกิดจากฝ่ายใดฝ่ายหนึ่งทำผิดสัญญานั้น
คือรูปแบบที่คำตอบกลับมา — คีย์และค่า สร้างจาก object { } และ array [ ] ซึ่งซ้อนกันได้ ชนิดข้อมูลคือ string, number, boolean, null, array, object
กับดักข้อความกับตัวเลข (42 เทียบกับ "42") และ ค่าที่หายไปเทียบกับ null คือบั๊กรูปทรงที่พบบ่อยที่สุด ตอนนี้คุณอ่าน JSON ออกแล้ว — เช็กชนิดข้อมูลเมื่อมีอะไรทำงานแปลกๆ
API key คือรหัสผ่าน ห้ามส่งไปที่เบราว์เซอร์ ห้าม ลง เก็บมันไว้ใน Key ที่รั่วไหลควรถูกหมุนเปลี่ยนทันที
ระวัง (429) และ การเรียกเก็บเงินแบบวัดปริมาณ — ลูปที่ AI เขียนขึ้นที่เรียก API เสียเงินโดยไม่หยุดพักคือวิธีที่ทำให้คุณได้ใบแจ้งหนี้สี่หลัก อ่านค่าบริการและตั้งการแจ้งเตือนงบประมาณก่อนเสมอ

ลองทำดู

หา API ฟรีที่ไม่ต้องใช้ key ในเบราว์เซอร์ของคุณ — ตัวอย่างเช่นเปิด https://api.github.com/users/octocat โดยตรงในแท็บใหม่ คุณจะเห็นคำตอบ JSON ดิบๆ อ่านมันเหมือนแบบฟอร์ม: หา object { } หา array ถ้ามี และระบุชนิดของค่าสามค่าที่ต่างกัน (อันไหนเป็น string อันไหนเป็น number อันไหนเป็น boolean มีอันไหนเป็น null ไหม) คุณเพิ่งทำการตรวจสอบด้วยสามัญสำนึกแบบเดียวกับที่บทนี้ขอให้คุณทำกับทุกคำตอบ API ที่ AI เชื่อมต่อให้

พรอมต์ประจำบท

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.

สรุปและแบบฝึกหัด

อยากได้แบบออฟไลน์?