Saladpuk.com
Search…
🏆 เนื้อหาหลัก
Software Design
Powered By GitBook
9.มาจัดกลุ่ม API กัน (2/2)
💬 หลังจากที่เราได้รู้ไปละว่าเราสามารถจัดกลุ่ม API เพื่อช่วยให้คนที่เข้ามาใช้งาน API สามารถเข้าใจการทำงานของ API เราได้ง่ายขึ้น คราวนี้เราจะมาลองดูกันว่า ถ้าเราจัดกลุ่ม และนำ verb มาช่วยด้วยมันจะทำให้ API ของเราเข้าใจได้ง่ายเป็นสากลได้ยังไงกันบ้างครับ

😢 ปัญหา

ตัวอย่างของ API ที่เรามีปัจจุบัน

Verb
Path
คำอธิบาย
GET
/api/Product/GetProducts
ดึงข้อมูลสินค้าทั้งหมด
GET
/api/Product/Get/{id}
ดึงข้อมูลสินค้า 1 ชิ้น
POST
/api/Product/CreateNewProduct
สร้างสินค้าใหม่
PUT
/api/Product/ChangeProduct/{id}
เปลี่ยนแปลงข้อมูลสินค้า
DELETE
/api/Product/DeleteProduct/{id}
ลบสินค้า
สมมุติว่าเราต้องมาใช้ API ที่อยู่ในตารางด้านบน เราจะพบปัญหาว่า เราจะไม่มีทางรู้เลยว่า API นั้นๆมันมีไว้ใช้ทำอะไรนอกจากไปอ่านคำอธิบายของมัน ถึงจะเข้าใจ

😄 วิธีแก้ปัญหา

จากตัวอย่างที่ว่ามาด้านบน เราลองใช้ verb ต่างๆเข้ามาช่วยดูซิ ซึ่งหน้าที่ของ verb แต่ละตัวมีหมายความตารางด้านล่างนี้
Verb
ความหมาย
GET
ขอข้อมูล
POST
สร้างข้อมูลใหม่
PUT
อัพเดทข้อมูล
DELETE
ลบข้อมูล
ดังนั้นผมจะลองเขียน API ใหม่ โดยให้ verb เป็นตัวกำหนดพฤติกรรมของมันดู เราก็ได้จะออกมาเป็นตารางด้านล่างนี้
Verb
Path
คำอธิบาย
GET
/api/Product
ดึงข้อมูลสินค้าทั้งหมด
GET
/api/Product/{id}
ดึงข้อมูลสินค้า 1 ชิ้น
POST
/api/Product
สร้างสินค้าใหม่
PUT
/api/Product/{id}
เปลี่ยนแปลงข้อมูลสินค้า
DELETE
/api/Product/{id}
ลบสินค้า
จากตารางด้านบนเราจะเห็นว่า API ของผมเหลือแค่แบบซ้ำๆกัน แต่ว่าเราใช้ verb เป็นตัวช่วยในการแยกการทำงานออกจากกัน ดังนั้น
ถ้าผมอยากดึงข้อมูลสินค้า 1 ตัวผมก็เรียกใช้ /api/Product/{id} ถ้าผมอยากดึงรายการสินค้าทั้งหมดผมก็ใช้ /api/Product
จะเห็นว่าถ้าเราเอาคอนเซ็ปนี้ไปใช้กับ API อื่นๆบ้าง เช่นการสั่งซื้อสินค้า เราก็จะได้เป็น
Verb
Path
คำอธิบาย
GET
/api/ProductOrder
ดึงข้อมูลการสั่งซื้อสินค้าทั้งหมด
GET
/api/ProductOrder/{id}
ดึงข้อมูลการสั่งซื้อสินค้า 1 ชิ้น
POST
/api/ProductOrder
สร้างการสั่งซื้อสินค้าใหม่
ซึ่งเราจะเห็นได้ว่า แม้ว่าผมจะมี Product API และ Product Order API ที่ทำงานไม่เหมือนกันก็ตาม แต่ด้วยการใช้ verb เข้ามาช่วย มันจะทำให้การทำความเข้าใจในการติดต่อกับ API ลดลง และในที่สุดเราก็แทบจะไม่จำเป็นต้องใส่คำอธิบายลงไปใน API เลยแต่ในขณะที่คนมาใช้ API ของเราก็ยังเข้าใจว่ามันทำงานยังไงอยู่นั่นเอง เช่น
ถ้าผมอยากดึงข้อมูลการสั่งซื้อสินค้า 1 ตัวผมก็เรียกใช้ /api/ProductOrder/{id} ถ้าผมอยากดึงรายการสั่งซื้อสินค้าทั้งหมดผมก็ใช้ /api/ProductOrder
Last modified 2yr ago