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