أدوات API المخصّصة

أدوات API المخصّصة هي وسيلة AnyBot لـ«ربط أي شيء». حين لا يكون لنظامٍ ما تكامل مدمج في هذه الصفحة، وجّه وكيلًا إلى REST API الخاص به بدلًا من ذلك: امنحه رابط أساس (base URL)، واختر نقاط النهاية، فتصبح كل واحدة منها أداة يستطيع الوكيل استدعاءها في منتصف المحادثة لجلب بيانات أو تشغيل إجراء, بلا أي برمجة مخصّصة.

متى تلجأ إليها

• لا يغطّي أي تكامل مدمج ذلك النظام, خدمة داخلية، أو SaaS متخصّص، أو الواجهة الخلفية الخاصة بك.
• لديك أصلًا REST API معروض (أو OpenAPI/Swagger spec) وتريد أن يستخدمه الوكيل.
• تريد أن يقرأ الوكيل بيانات مباشرة أو أن يشغّل إجراءً يقبع خلف نقطة نهاية خاصة بك.

إن كان هناك تكامل من الدرجة الأولى موجود أصلًا, إدارة علاقات العملاء، أو التجارة، أو Notion، أو البحث على الويب, فالجأ إليه أولًا. فهو مصان نيابةً عنك وواعٍ بالخصوصية أصلًا، ما يوفّر عليك إعداد المخطّط والمصادقة.

كيف يتمّ الربط (النسخة المختصرة)

1. افتح التكاملات، واختر API مخصّص، وامنحه رابط أساس.
2. استورد OpenAPI/Swagger spec (برابط أو بلصق المحتوى) لاكتشاف نقاط النهاية تلقائيًا، أو اضبط الأدوات يدويًا.
3. اضبط المصادقة, Bearer أو Basic أو API Key أو بلا مصادقة.
4. اختر نقاط النهاية التي تريد عرضها، واختبر كلًّا منها في اللوحة المدمجة، ثم اضغط اربط.

المزلق الحقيقي: لا يستطيع الوكيل الوصول إلّا إلى ما تعرضه أنت. فاستيراد spec يسرد كل نقطة نهاية يعثر عليها، لكن ما تختاره أنت وحده هو ما يصبح أدوات, كما أنّ إعادة تحليل الـ spec لاحقًا تلتقط تغييرات API بلا إعادة بناء من الصفر.

عامّة أم خاصة، لكل أداة

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

ولأنّ الأدوات تُعرَّف لكل نسخة على حدة، فلا توجد قائمة أو عدد ثابت, فالسطح هو بالضبط ما تبنيه أنت.

مثال عملي

طلباتك تقيم في خدمة داخلية بلا تكامل مدمج. توجّه أداة API مخصّصة إلى https://api.internal.example.com، وتستورد OpenAPI spec الخاص بها، وتعرض نقطة نهاية واحدة للقراءة فقط, get_order_status, كأداة عامّة. يسأل زائر «أين الطلب 4821؟» فيستدعيها الوكيل ويجيب بالحالة المباشرة. وتُبقي نقطة نهاية ردّ المبلغ خاصة، فلا يصل إليها سوى القنوات الموجَّهة للموظّفين.

الحدود

• صادرة فقط. الوكيل يستدعي الـ API لديك، ولا يستدعي الـ API لديك الوكيل.
• يستخدم الوكيل بيانات الاعتماد التي تضبطها؛ ولا يمكنه أبدًا تجاوز ما يُسمح به لمفتاح API ذاك.
• إزالة التكامل تفصل الأدوات فحسب, ولا تُجرى أي تغييرات على API الخارجي لديك.

استكشاف الأخطاء

• الـ spec لا يُحلَّل. تأكّد من أنه OpenAPI/Swagger صالح ويمكن الوصول إليه؛ والصق المحتوى الخام إن كان الرابط محميًّا.
• فشلت المصادقة. راجِع الرمز، وبادئته، وما إذا كان المفتاح ينتمي إلى ترويسة أم إلى معامل استعلام.
• الوكيل لا يستدعي الأداة. تأكّد من أنّ نقطة النهاية مختارة/معروضة وأنّ مدى ظهورها يطابق القناة, فالأداة الخاصة لن تعمل على وكيل عامّ.

الأسئلة الشائعة

هل عليّ كتابة برمجية؟ لا. اربط REST API عبر spec أو يدويًا, بلا أي برمجة.

هل يمكنها استدعاء أي API؟ أي نقطة نهاية HTTP REST يمكن الوصول إليها وتستطيع المصادقة عليها.

كم أداة يمكنني تعريفها؟ لا يوجد عدد ثابت, ابنِ منها ما تحتاج.

التالي

• نظرة عامة على التكاملات