API คืออะไรกันแน่
วิธีที่เข้าใจง่ายที่สุดคือมอง เป็น เมนูของคำขอที่โปรแกรมหนึ่งเปิดให้อีกโปรแกรมหนึ่งสั่งได้
ร้านอาหารจะไม่ปล่อยให้คุณเดินเข้าไปในครัวแล้วทำอาหารเอง มันจะยื่นเมนูให้คุณแทน: นี่คือสิ่งที่คุณสั่งได้ นี่คือวิธีสั่ง และนี่คือสิ่งที่คุณจะได้กลับมา คุณไม่จำเป็นต้องรู้ว่าครัวทำงานอย่างไร คุณแค่ต้องมีเมนู API ก็เป็นแบบนั้นเป๊ะ — บริษัทหนึ่งบอกว่า "นี่คือคำขอที่คุณสั่งบริการของเราได้ และนี่คือสิ่งที่แต่ละคำขอจะให้กลับมา"
เมื่อ AI เขียนโค้ดที่ "เรียก weather API" มันกำลังสั่งของจากเมนูนั้น: ขอพยากรณ์อากาศของเมืองนี้หน่อย เซิร์ฟเวอร์ของบริษัทพยากรณ์อากาศจะทำงานแล้วส่งคำตอบกลับมา แอปของคุณไม่มีวันเห็นฐานข้อมูลหรือโค้ดของพวกเขา คุณแค่ได้รับ "จาน" ที่เสิร์ฟมา
┌────────────┐ request: GET /forecast?city=London ┌────────────┐
│ YOUR APP │ ─────────────────────────────────────▶ │ API │
│ (client) │ │ endpoint │
│ │ ◀───────────────────────────────────── │ (server) │
└────────────┘ response: { "temp": 14, ... } (JSON) └────────────┘
orders off does the work,
the menu sends the dish
การเปลี่ยนมุมมองที่สำคัญคือ: API คือ สัญญา บริษัทอีกฝ่ายสัญญาว่าถ้าคุณถามในรูปแบบที่กำหนดไว้ คุณจะได้คำตอบในรูปแบบที่กำหนดไว้เช่นกัน หน้าที่ของคุณ — และของ AI — คือการถามให้ถูกต้องและอ่านคำตอบให้ถูกต้อง บั๊กของ API ส่วนใหญ่เกิดจากฝ่ายใดฝ่ายหนึ่งทำผิดสัญญานั้น