API คือ "ข้อตกลง" ไม่ใช่แค่ URL

หลายคนเข้าใจว่า API คือ URL เพียงอย่างเดียว ซึ่งถูกต้องเพียงบางส่วน จริง ๆ แล้ว API คือข้อตกลงระหว่างสองระบบว่า หากต้องการสื่อสารกัน ต้องส่งข้อมูลใดไป และจะได้รับข้อมูลใดกลับมา

เข้าใจผิดที่ 1: API คือ URL อย่างเดียว

URL เป็นเพียงที่อยู่ของปลายทาง แต่ API ยังรวมถึงวิธีเรียกใช้งาน (method), ข้อมูลที่ต้องส่งไป (body), ข้อมูลกำกับคำขอ (headers) และรูปแบบของผลลัพธ์ที่ได้รับกลับมา (response)

เข้าใจผิดที่ 2: เว็บกับแอปมือถือต้องมี API คนละชุด

ไม่จำเป็นเสมอไป หากออกแบบระบบดี เว็บและแอปมือถือสามารถเรียกใช้ API ชุดเดียวกันได้ โดยต่างกันเฉพาะหน้าตาและประสบการณ์การใช้งาน

เข้าใจผิดที่ 3: ถ้าหน้าเว็บ error หมายความว่า API มีปัญหาเสมอ

ไม่เสมอไป หลายครั้งปัญหาเกิดจากการส่งคำขอไม่ถูกต้อง เช่น URL ผิด เรียกข้อมูลที่ไม่มีอยู่จริง หรือส่งข้อมูลไม่ครบ

• ✓อธิบายได้ว่า API เปรียบเหมือนพนักงานเสิร์ฟอย่างไร
• ✓เข้าใจว่าไม่จำเป็นต้องรู้รายละเอียดเบื้องหลังทั้งหมด แต่ต้องรู้วิธีส่งคำขอและรูปแบบผลลัพธ์ที่จะได้รับ
• ✓รู้ว่า API คือข้อตกลง ไม่ใช่แค่ URL