Endpoint และ REST แบบเข้าใจง่าย
คือรายการหนึ่งในเมนู มันเป็นแค่ (Uniform Resource Locator หรือ ตัวระบุตำแหน่งทรัพยากรสากล) ที่ทำหน้าที่เฉพาะอย่างหนึ่ง ตัวอย่างเช่น:
https://api.weather.com/forecast— ขอพยากรณ์อากาศhttps://api.weather.com/cities— ดูรายชื่อเมืองที่มีข้อมูล
ครัวเดียวกัน แต่จานอาหารต่างกัน แต่ละ endpoint คือความสามารถหนึ่งอย่าง
ส่วนใหญ่ที่คุณจะได้เจอทำตามสไตล์กว้างๆ ที่เรียกว่า (Representational State Transfer) คุณไม่จำเป็นต้องรู้นิยามทางวิชาการ แต่คุณต้องเข้าใจสองแนวคิดนี้:
- URL ระบุ "สิ่งของ" (เรียกว่า "resource" หรือ ทรัพยากร) — ผู้ใช้คนหนึ่ง คำสั่งซื้อหนึ่งรายการ พยากรณ์อากาศหนึ่งชุด
- คำกริยาบอกว่าคุณอยากทำอะไรกับมัน คำกริยาเหล่านี้คือเมธอดของ (HyperText Transfer Protocol) ซึ่งเป็นตัวเดียวกับที่มาจากบทเรื่องเว็บทำงานอย่างไร:
GET— อ่านข้อมูล (ดึงพยากรณ์อากาศ) ปลอดภัย ไม่เปลี่ยนแปลงอะไรPOST— สร้างข้อมูลใหม่ (สั่งซื้อของ สมัครสมาชิกผู้ใช้ใหม่)PUT/PATCH— อัปเดตข้อมูลที่มีอยู่แล้วDELETE— ลบข้อมูล
ดังนั้น GET /orders/42 หมายถึง "อ่านคำสั่งซื้อหมายเลข 42" และ DELETE /orders/42 หมายถึง "ลบมันทิ้ง" คำนามเดียวกัน คำกริยาต่างกัน ผลลัพธ์ต่างกันโดยสิ้นเชิง เมื่อคุณอ่านเอกสาร API หรือ diff คำสองคำนี้ — เมธอด และ URL — จะบอกคุณเกือบทั้งหมดว่าคำขอนั้นทำอะไร