لمحة عن واجهات برمجة تطبيقات RESTful

REST هي نمط من بنية البرامج التي توفر نهجًا مريحًا ومتسقًا لطلب البيانات وتعديلها.

يشير مصطلح REST إلى "تحويل الولاية التمثيلية". في سياق Google APIs، يشير إلى استخدام أفعال HTTP لاسترداد وتعديل تمثيلات البيانات التي خزّنتها Google.

في نظام RESTful، يتم تخزين الموارد في مخزن بيانات؛ ويرسل العميل طلبًا بأن ينفِّذ الخادم إجراءً معينًا (مثل إنشاء مورد أو استرداده أو تحديثه أو حذفه)، وينفّذ الخادم الإجراء ويرسل استجابة، غالبًا في شكل تمثيل للمورد المحدّد.

في واجهات برمجة التطبيقات RESTful الخاصة بـ Google، يحدد العميل إجراءً باستخدام فعل HTTP، مثل POST أو GET أو PUT أو DELETE. ويحدّد موردًا من خلال معرّف موارد منتظم (URI) فريد عالميًا بالتنسيق التالي:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

ونظرًا لاحتواء جميع موارد واجهة برمجة التطبيقات على عناوين URI فريدة يمكن الوصول إليها عبر HTTP، تتيح REST تخزين البيانات مؤقتًا، كما يتم تحسينها للعمل مع البنية الأساسية الموزعة للويب.

قد تجد تعريفات الطرق في مستندات معايير HTTP 1.1 مفيدة، حيث تتضمّن مواصفات GET وPOST وPUT وDELETE.