REST คือสถาปัตยกรรมซอฟต์แวร์รูปแบบหนึ่งที่ให้แนวทางที่สะดวกและสอดคล้องกันในการส่งคำขอและแก้ไขข้อมูล
คำว่า REST ย่อมาจาก "การโอนสถานะตัวแทน" ในบริบทของ Google APIs คำว่า Google API จะหมายถึงการใช้คำกริยา HTTP เพื่อเรียกและแก้ไขการนำเสนอข้อมูลที่ Google เก็บไว้
ในระบบ RESTful ทรัพยากรจะเก็บอยู่ในพื้นที่เก็บข้อมูล ไคลเอ็นต์จะส่งคำขอให้เซิร์ฟเวอร์ดำเนินการบางอย่าง (เช่น สร้าง เรียก อัปเดต หรือลบทรัพยากร) และเซิร์ฟเวอร์จะดำเนินการและส่งคำตอบ ซึ่งมักจะอยู่ในรูปแบบการนำเสนอทรัพยากรที่ระบุ
ใน RESTful API ของ Google ไคลเอ็นต์จะระบุการดำเนินการโดยใช้คำกริยา HTTP เช่น POST
, GET
, PUT
หรือ DELETE
และระบุทรัพยากรด้วย URI ที่ไม่ซ้ำกันทั่วโลกของรูปแบบต่อไปนี้
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
เนื่องจากทรัพยากร API ทั้งหมดมี URI ที่เข้าถึงได้ด้วย HTTP ที่ไม่ซ้ำกัน REST จึงเปิดใช้การแคชข้อมูลและมีการเพิ่มประสิทธิภาพเพื่อทำงานกับโครงสร้างพื้นฐานแบบกระจายของเว็บ
คุณอาจพบว่าคำจำกัดความของเมธอดในเอกสารมาตรฐาน HTTP 1.1 มีประโยชน์ โดยรวมถึงข้อกำหนดสำหรับ GET
, POST
, PUT
และ DELETE