# 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**