REST API ในโปรโตคอล HTTP

โดยทั่วไปเมื่อสร้างเว็บไซต์ สำหรับการรับ สร้าง เปลี่ยนแปลง และลบข้อมูล มักใช้เพียง วิธีการ GET และ POST เท่านั้น เนื่องจากทั้งสองวิธีนี้ได้รับการสนับสนุนเป็นอย่างดี จากเบราว์เซอร์และเซิร์ฟเวอร์ เช่นเดียวกับ API ที่เว็บไซต์ให้บริการ อย่างไรก็ตาม มี แนวทางเฉพาะทาง ที่กำหนดมาตรฐาน API เพื่อความสะดวกโดยรวม ทั้งสำหรับผู้พัฒนา API และผู้ใช้งาน API

แนวทางหนึ่งคือ REST API (มักเรียกว่า RESTful โดยใช้คำนี้ เป็นคำคุณศัพท์) พื้นฐานของ API นี้คือการใช้งานอย่างกว้างขวางของ วิธีการต่างๆ ในโปรโตคอล HTTP ในแนวทางนี้ โดยใช้วิธีการ GET เพื่อรับข้อมูล ใช้วิธีการ POST เพื่อสร้าง ใช้วิธีการ PUT เพื่อเปลี่ยนแปลง และใช้วิธีการ DELETE เพื่อลบ

เพื่อเป็นตัวอย่าง ลองพิจารณา API บางอย่าง ที่จัดการกับผู้ใช้ มาดูกันว่า URL สำหรับการดำเนินการต่างๆ จะมีลักษณะอย่างไร

รับผู้ใช้ทั้งหมด:

urlGET http://api.loc/users/

รับผู้ใช้หนึ่งคนตาม id ของเขา:

urlGET http://api.loc/user/1/

สร้างผู้ใช้:

urlPOST http://api.loc/user/

เปลี่ยนแปลงผู้ใช้ตาม id ของเขา:

urlPUT http://api.loc/user/1/

ลบผู้ใช้ตาม id ของเขา:

urlDELETE http://api.loc/user/1/