🔌 مرجع REST API بالعربي
كل طريقة HTTP وترويسة ومفهوم أساسي في REST APIs بالعربي: ماذا يفعل، صياغته، مثال يوضّحه، وأشهر الأخطاء — مفاهيم بروتوكول وليست لغة برمجة، فلا يوجد تشغيل حي في المتصفح. حاليًا 12 عنصر — والقائمة تكبر.
طرق HTTP
GET
طريقة GET
GET تطلب تمثيل مورد دون تغييره — الطريقة الأكثر استخدامًا في أي REST API.
POST
طريقة POST
POST ترسل بيانات لإنشاء مورد جديد أو تنفيذ عملية على الخادم، وهي غير آمنة وغير عديمة الأثر التراكمي.
PUT
طريقة PUT
PUT تستبدل مورداً بالكامل بالتمثيل المُرسَل، وهي عديمة الأثر التراكمي رغم أنها تُغيّر البيانات.
PATCH
طريقة PATCH
PATCH تُطبِّق تعديلًا جزئيًا على مورد قائم، عرّفتها RFC 5789 كإضافة منفصلة عن مواصفة HTTP الأساسية.
DELETE
طريقة DELETE
DELETE تطلب إزالة المورد المحدَّد بالرابط، وهي عديمة الأثر التراكمي حسب المواصفة.
HEAD
طريقة HEAD
HEAD تتصرف مثل GET لكنها تعيد الترويسات فقط دون جسم الاستجابة — مفيدة لفحص وجود مورد أو حجمه دون تحميله.
OPTIONS
طريقة OPTIONS
OPTIONS تسأل الخادم عن خيارات التواصل المتاحة لمورد معيّن — الطرق المسموحة، وهي أساس آلية CORS preflight.
ترويسات ومفاهيم REST
ETag
ترويسة ETag والطلبات الشرطية
ETag معرّف فريد لنسخة معيّنة من مورد، يسمح للعميل بالتحقق إن كان المورد تغيّر دون تحميله كاملًا مجددًا.
Idempotency-Key
ترويسة Idempotency-Key
ترويسة يولّدها العميل لجعل طلبات POST غير الآمنة قابلة لإعادة المحاولة بأمان دون تكرار العملية الفعلية.
Location
ترويسة Location
ترويسة استجابة تدلّ العميل على رابط المورد — إما مورد جديد أُنشئ (201) أو وجهة إعادة توجيه (3xx).
Accept / Content-Type
التفاوض على المحتوى (Content Negotiation)
آلية تسمح للعميل والخادم بالاتفاق على صيغة تمثيل المورد المتبادل — عبر ترويسات Accept وContent-Type.
HATEOAS
HATEOAS ومستويات نضج REST
القيد الرابع والأعلى في REST الأصلي: تضمين روابط في الاستجابة تدلّ العميل على الإجراءات المتاحة تاليًا.
🎓 تريد التعلم بالترتيب بدل المرجع السريع؟ ابدأ من مسار REST-API الكامل بالعربي.