ในโลกของการพัฒนาซอฟต์แวร์สมัยใหม่ การสื่อสารข้อมูลระหว่างระบบ (Microservices) ไม่ได้เกิดขึ้นด้วยการส่งไฟล์โดยตรง แต่ต้องอาศัย Application Programming Interface (API) เป็นตัวกลางในการทำงาน API เปรียบเสมือนสัญญาที่กำหนดวิธีการร้องขอและรับข้อมูล ทำให้ผู้พัฒนาสามารถสร้างระบบที่ซับซ้อนและขยายขนาดได้ การทำความเข้าใจวิธีการเรียกใช้ API พื้นฐาน โดยเฉพาะคำสั่ง GET จึงเป็นทักษะที่นักพัฒนารุ่นใหม่ทุกคนต้องเชี่ยวชาญ
🚀 Postman 101: ทำความเข้าใจ GET Request และ Query Parameters
Postman คือเครื่องมือมาตรฐานที่ช่วยให้เราสามารถทดสอบและเรียกใช้ API ได้อย่างง่ายดาย สำหรับการเรียกใช้ข้อมูล (Read Operation) เราจะใช้ HTTP Method ที่ชื่อว่า GET โดยหลักการแล้ว GET คือการร้องขอข้อมูลจากเซิร์ฟเวอร์โดยที่ Client ไม่ได้ส่งข้อมูลใดๆ เข้าไปในการร้องขอ แต่เป็นการระบุว่าต้องการ ‘อะไร’ และ ‘จากที่ไหน’
🔑 หัวใจสำคัญ: Query Parameters
เมื่อข้อมูลที่เราต้องการมีเงื่อนไขการกรอง (Filtering) หรือการจำกัดขอบเขต (Limiting) การใช้ Query Parameters คือสิ่งจำเป็นที่สุด Query Parameters จะถูกแนบต่อท้าย URL เสมอด้วยเครื่องหมาย ? และตามด้วยคู่ Key-Value ที่คั่นด้วยเครื่องหมาย &
ตัวอย่าง: หากเราต้องการดึงรายการสินค้าที่อยู่ในหมวดหมู่ ‘Electronics’ และมีราคาระหว่าง 100 ถึง 500 เราจะส่งพารามิเตอร์เหล่านี้ไปพร้อมกัน เพื่อให้ API สามารถกรองข้อมูลขนาดใหญ่ให้เหลือเฉพาะชุดที่เราสนใจได้ นี่คือการทำให้ API มีความยืดหยุ่นและทรงพลังในการใช้งานจริง
⚙️ การทำงานเบื้องหลัง: การส่ง Query Parameter ไปยัง PostgreSQL
เมื่อเราส่ง GET Request ไปยัง API Endpoint ตัว API นั้นจะทำหน้าที่เป็นตัวกลางในการรับค่าพารามิเตอร์เหล่านี้ แล้วส่งต่อไปยังฐานข้อมูลจริง ซึ่งในตัวอย่างนี้เราจะสมมติว่า Backend ของเราใช้ PostgreSQL ในการจัดการข้อมูล
สมมติว่า API Endpoint ของเราคือ /api/products และเราต้องการกรองตาม category และ min_price การเรียกใช้ GET จะถูกแปลงเป็นคำสั่ง SQL ที่มีเงื่อนไขการกรองดังนี้:
SQL
-- นี่คือโค้ด SQL ที่ Backend จะรันเมื่อได้รับ GET Request ที่มี Query Params<br>SELECT<br> product_name,<br> category,<br> price<br>FROM<br> products<br>WHERE<br> category IN ('apple', 'banana', 'orange')<br> AND price BETWEEN 100 AND 500;<br>
✅ การอ่าน Response Status Code
เมื่อส่งคำขอ (Request) ไปแล้ว สิ่งสำคัญไม่แพ้กันคือการตรวจสอบการตอบกลับ (Response) ซึ่งประกอบด้วยข้อมูล (Body) และ Status Code Status Code คือรหัสตัวเลขที่บอกสถานะของการร้องขอว่าสำเร็จหรือไม่สำเร็จ
- 200 OK: หมายถึงการร้องขอสำเร็จ ข้อมูลอยู่ใน Body พร้อมใช้งาน
- 400 Bad Request: หมายถึง Client ส่งพารามิเตอร์ผิดพลาด (เช่น ส่งค่าที่ไม่ใช่ตัวเลขไปในช่องราคา)
- 404 Not Found: หมายถึง Endpoint ที่เรียกใช้ไม่มีอยู่จริง
- 500 Internal Server Error: หมายถึงเกิดข้อผิดพลาดที่ฝั่ง Server (Backend)
💡 บทสรุปสำหรับ Senior Developer
การทำความเข้าใจการทำงานของ GET Request, การส่ง Query Parameters, และการตรวจสอบ Status Code ไม่ใช่แค่การใช้เครื่องมือ แต่คือการเข้าใจหลักการสื่อสารข้อมูลระหว่างระบบ การฝึกฝนการส่งพารามิเตอร์ที่ถูกต้องและการตรวจสอบ Status Code อย่างละเอียด จะช่วยให้คุณสามารถออกแบบและใช้งาน API ได้อย่างมีประสิทธิภาพและเป็นมืออาชีพ