نقطة نهاية بالعلامة البيضاء

نقطة النهاية بالعلامة البيضاء هي نقطة نهاية يضيفها موزّع إلى الواجهة البرمجية التي يبيعها باسمه الخاص. وهي ليست قدرة جديدة — بل بضع عمليات تملكها تلك الواجهة أصلاً، مرتّبة بالتسلسل، خلف عنوان واحد واسم واحد اختارهما الموزّع. يستدعيها عملاؤه كما يستدعون أي شيء آخر، ويراها مساعدو العملاء في قائمة الأدوات إلى جانب العمليات التي بُنيت منها.

لماذا يريدها الموزّع

لأن المنتج الذي يبيعه ليس في الغالب عملية واحدة. فعبارة «نسخّن لك قائمة» تعني بحثاً، ثم تفاعلاً مع كل نتيجة، ثم دعوة إلى الأشخاص الذين كتبوها — أربعة استدعاءات يجب أن يؤديها مساعدو عملائه بشكل صحيح وبالترتيب في كل مرة. أما نقطة النهاية الواحدة فهي العمل نفسه، مسمّى مرة واحدة، ومشروحاً بكلمات الموزّع نفسه.

ما يمكن بناؤها منه وما لا يمكن

من العمليات التي تشملها خطة الموزّع نفسه فقط. فنقطة النهاية الخاصة به اختصار داخل الواجهة التي اشتراها، وليست أبداً طريقاً للالتفاف عليها: الخطوة التي تسمّي شيئاً خارج خطته تُرفض عند كتابة نقطة النهاية، لا عند تشغيلها.

الشروط والحلقات التكرارية مسموحة، أما لغة التعبيرات فلا. القيمة هي JSON عادي أو مسار يُقرأ من التشغيل حتى تلك اللحظة، والشرط مقارنة. لا يُقيَّم شيء، لأن نقطة النهاية يكتبها عميل، وتُخزَّن، ثم تُشغَّل على خادم المزوّد على حساب حقيقي.

كم يمكن أن يستهلك استدعاء واحد

الحلقة التكرارية تعني أن نقطة النهاية قد تطلب عملاً أكثر مما قصد أحد أن يطلبه، ولذلك فللتشغيل الواحد حدود: عدد من العمليات، وعدد من التكرارات، ومهلة زمنية. وبلوغ أحد هذه الحدود جواب لا خطأ — فهو يذكر ما أُنجز فعلاً، لأنه لا سبيل إلى استرجاع رسالة أُرسلت.

النصف الآخر: إزالة ما هو لنا

يستطيع الموزّع أيضاً إخفاء العمليات التي لا يريد عرضها. فالإخفاء يُخرج العملية من قائمة الأدوات وملف البيان والمرجع؛ أما المسار فيظل يجيب، ولذلك فإن العميل الذي يستدعيه أصلاً لا ينكسر بسبب تغيير أُجري بجملة واحدة. أما الموزّع الذي يريد إزالة مجال كامل فيكفّ بدلاً من ذلك عن عرض ذلك المجال.

أسئلة شائعة