REST APIواجهة REST
ما هو REST API؟
REST هو العُرف المشترك الذي تتبعه معظم واجهات البرمجة فتتشابه طريقة التعامل معها.
ما معنى REST API بالعربي؟
الاسم المعتمد الآن هو «واجهة REST». ولأن كثيرًا من المصطلحات لم يستقرّ لها اسم عربي واحد، يكتب هذا القاموس قرّاؤه: صوّت للاسم الذي تراه أوضح، أو اقترح اسمًا أفضل. نراجع الأصوات في كل جولة ونعتمد ما يختاره الناس.
-
واجهة REST الاسم المعتمد اسم القاموس
-
ريست إيه بي آي تعريب صوتي شائع بين المطورين
-
واجهة نقل الحالة التمثيلية ترجمة الاسم الكامل في المراجع
صوت واحد لكل قارئ في كل مصطلح، وتستطيع نقله إلى اسم آخر. حين يتجاوز اسمٌ الاسمَ المعتمد ويصل إلى 5 أصوات على الأقل، نعرضه للاعتماد في الجولة التالية.
اقترح اسمًا عربيًا أفضل
هل الشرح غير واضح أو فيه خطأ؟
تخيّل لو أن لكل مطعم نافذة مختلفة تمامًا: واحدة على ارتفاع مترين، وأخرى تقبل الطلب بالإشارات فقط، وثالثة تطلب منك رقمًا سريًا قبل أن تقول كلمة. ستتعلّم الطلب من جديد في كل مرة. في المقابل، لو اتفقت المطاعم كلها على شكل واحد للنافذة ولوحة بالنمط نفسه، فستطلب من أي مطعم بثقة حتى لو كانت زيارتك الأولى.
REST هو هذا الاتفاق. ليس برنامجًا ولا شركة، بل مجموعة قواعد يختار معظم مصمّمي واجهات البرمجة اتباعها حتى تبدو نوافذهم مألوفة لأي مطوّر.
يقوم الاتفاق على فكرتين بسيطتين:
- كل شيء «عنصر» له عنوان ثابت. الطلبات تسكن في
/orders، والعملاء في/customers، والمنتجات في/products. لا تطلب «ابحث لي عن بيانات» بل تذهب إلى الرف المخصص. - تتعامل مع هذه العناصر بعدد صغير جدًا من الأفعال: اقرأ، أنشئ، عدّل، احذف. لا مئة أمر خاص لكل خدمة.
حين تجتمع الفكرتان تصير الطلبات شبه مقروءة: اذهب إلى رف الطلبات واقرأ ما فيه؛ اذهب إلى رف المنتجات وأنشئ منتجًا جديدًا. ويأتي الرد في الغالب على بطاقة JSON مصحوبًا برقم حالة يخبرك بما جرى: 200 حين ينجح الطلب، و404 حين لا يوجد ما طلبته. هذا التوقّع المسبق هو كل الفكرة: المطوّر الذي ربط متجرك بخدمة دفع الأسبوع الماضي يستطيع ربطه بخدمة شحن هذا الأسبوع في وقت أقل بكثير، لأن النافذتين تشبهان بعضهما.
لحظة من حياتك: تقارن بين أداتين لإدارة حملات رمضان على WhatsApp، فتقرأ في صفحة إحداهما «توفر REST API». هذه الجملة الصغيرة تعني: هذه الأداة تتصرف بالطريقة المتوقعة، وأدواتك الحالية ستتفاهم معها على الأرجح دون حِيَل خاصة.
لماذا يهمك REST API؟
لن تحتاج يومًا إلى بناء واجهة REST أو حفظ قواعدها، لكنك ستفهم سبب ارتياح المطوّر حين يسمع الكلمة، وسبب تذمّره حين يقول إن خدمة ما «ليست RESTful»: الثانية تعني وقتًا أطول وتكلفة أعلى لأن لها طريقتها الخاصة في كل شيء.
متى ستسمع كلمة REST API؟
تسأل عن ربط خدمة جديدة فيطمئنك المطوّر: «لها واجهة REST عادية، سأنتهي منها اليوم».
