PlusMagi's Blog By Pitt Phunsanit Backend,Database,Technical Guide,Technology คู่มือใช้งาน Postman ยิง REST/RESTful API ทุกรูปแบบ: เจาะลึก GET, POST, PUT, PATCH, DELETE พร้อมตัวอย่าง Payload

คู่มือใช้งาน Postman ยิง REST/RESTful API ทุกรูปแบบ: เจาะลึก GET, POST, PUT, PATCH, DELETE พร้อมตัวอย่าง Payload

ในโลกของการพัฒนาซอฟต์แวร์ยุคใหม่ การสื่อสารระหว่างระบบต่างๆ ไม่ได้จำกัดอยู่แค่หน้าจอผู้ใช้งานอีกต่อไป แต่เป็นการแลกเปลี่ยนข้อมูลผ่านช่องทางที่เรียกว่า API (Application Programming Interface) ซึ่งเป็นหัวใจสำคัญที่ทำให้บริการดิจิทัลสามารถเชื่อมต่อและทำงานร่วมกันได้อย่างไร้รอยต่อ

การทำความเข้าใจว่าแต่ละ HTTP Method มีหน้าที่อะไรในการจัดการทรัพยากร (Resource) จึงเป็นทักษะพื้นฐานที่นักพัฒนาทุกคนต้องเชี่ยวชาญ และ Postman คือเครื่องมือสำคัญที่ช่วยให้เราสามารถจำลองการเรียกใช้ API เหล่านี้ได้จริง บทความนี้จะเจาะลึกการใช้งาน RESTful API ทั้ง 5 รูปแบบ (CRUD) โดยใช้หลักการทำงานที่เชื่อมโยงกับฐานข้อมูล PostgreSQL

หลักการทำงานของ RESTful API กับ PostgreSQL

RESTful API อาศัยหลักการของ HTTP Verbs ในการกำหนดรูปแบบการดำเนินการกับทรัพยากร (Resource) ซึ่งแต่ละ Method มีความหมายเฉพาะตัวที่ต้องเข้าใจอย่างถ่องแท้ โดยเราจะเปรียบเทียบการทำงานของแต่ละ Method กับคำสั่ง SQL ใน PostgreSQL:

1. GET (Read – อ่านข้อมูล)

หน้าที่: ใช้สำหรับดึงข้อมูล (Read) โดยไม่มีผลกระทบต่อสถานะของเซิร์ฟเวอร์ เป็นคำสั่งที่ปลอดภัย (Safe) และสามารถเรียกซ้ำได้โดยไม่เกิดการเปลี่ยนแปลง (Idempotent) ใน Postman จะใช้ Method นี้เพื่อเรียกดูข้อมูลทั้งหมดหรือข้อมูลเฉพาะรายการ

เทียบเท่า PostgreSQL: SELECT

SQL

-- ดึงรายการสินค้าทั้งหมดจากตาราง products<br>SELECT * FROM products;<br>

2. POST (Create – สร้างข้อมูล)

หน้าที่: ใช้สำหรับสร้างทรัพยากรใหม่ (Create) ข้อมูลจะถูกส่งไปใน Body ของ Request (Payload) เหมาะสำหรับการส่งข้อมูลชุดใหม่เพื่อสร้างรายการใหม่ในฐานข้อมูล

เทียบเท่า PostgreSQL: INSERT

SQL

-- สร้างผู้ใช้ใหม่ โดยส่ง payload เป็นชื่อและอีเมล<br>INSERT INTO users (username, email) VALUES ('john_doe', '[email protected]');<br>

3. PUT (Update/Replace – อัปเดตทั้งหมด)

หน้าที่: ใช้สำหรับอัปเดตทรัพยากรทั้งหมด (Update/Replace) หากเราต้องการแทนที่ข้อมูลเดิมทั้งหมดด้วยข้อมูลชุดใหม่ที่สมบูรณ์ เราจะใช้ PUT โดยต้องระบุ ID ของทรัพยากรนั้น ๆ เสมอ

เทียบเท่า PostgreSQL: UPDATE ... SET ... WHERE id = X

SQL

-- อัปเดตข้อมูลสินค้า ID 101 ทั้งหมด<br>UPDATE products SET name = 'Smart Phone X', price = 15000 WHERE product_id = 101;<br>

4. PATCH (Partial Update – อัปเดตบางส่วน)

หน้าที่: ใช้สำหรับอัปเดตเพียงบางส่วนของทรัพยากร (Partial Update) เหมาะเมื่อเราต้องการแก้ไขเพียงฟิลด์เดียว (เช่น เปลี่ยนแค่ชื่อ) โดยไม่กระทบกับข้อมูลอื่น ๆ ที่มีอยู่แล้ว

เทียบเท่า PostgreSQL: UPDATE ... SET column = value WHERE id = X

SQL

-- แก้ไขเฉพาะสถานะสินค้า ID 202 ให้เป็น 'Out of Stock'<br>UPDATE products SET stock_status = 'Out of Stock' WHERE product_id = 202;<br>

5. DELETE (Delete – ลบข้อมูล)

หน้าที่: ใช้สำหรับลบทรัพยากรออกจากระบบอย่างถาวร (Delete) ต้องระบุตัวระบุ (ID) ของทรัพยากรที่ต้องการลบอย่างชัดเจน

เทียบเท่า PostgreSQL: DELETE

SQL

-- ลบผู้ใช้ที่มี ID 5 ออกจากระบบ<br>DELETE FROM users WHERE user_id = 5;<br>

บทสรุป: การเลือกใช้ Method ที่ถูกต้อง

การเลือกใช้ HTTP Method ที่ถูกต้อง (GET, POST, PUT, PATCH, DELETE) ไม่ได้เป็นเพียงแค่การเขียนโค้ด แต่คือการแสดงความเข้าใจในหลักการจัดการข้อมูล (CRUD) ที่เหมาะสมกับสถานการณ์นั้น ๆ การใช้ Postman เพื่อจำลองการเรียก API เหล่านี้ให้สัมพันธ์กับการทำงานของ PostgreSQL อย่างถูกต้อง จะช่วยให้ระบบของคุณมีความเสถียร ปลอดภัย และเป็นไปตามมาตรฐาน RESTful อย่างแท้จริง