تكامل API المخصص

أداة استدعاء API تتيح لك ربط Crew بأي خدمة خارجية لديها REST API. هذه أكثر أدوات Crew مرونةً — إذا كان للخدمة API، يمكنك ربطها.

كيف يعمل

1. خزّن بيانات اعتماد API في الإعدادات

2. اطلب من Crew استدعاء API بلغة طبيعية

3. ينشئ Crew طلب API ويُرجع النتائج

إعداد بيانات الاعتماد

قبل استخدام API خارجي، خزّن مفتاح API:

1. اذهب إلى الإعدادات

2. انتقل إلى بيانات اعتماد API (أو اضبطها عند تثبيت مهارة من المتجر تتطلب ذلك)

3. أضف بيانات اعتمادك:

   • اسم المفتاح: تسمية مثل MY_SERVICE_API_KEY

   • القيمة: مفتاح API الفعلي

بيانات الاعتماد مشفرة ومخزّنة بأمان. عند استدعاء Crew لـ API، يُدخل بيانات الاعتماد باستخدام عنصر نائب {{KEY_NAME}} — المفتاح الفعلي لا يظهر أبداً في المحادثة.

إجراء استدعاءات API

طلب GET بسيط

"استدعِ JSONPlaceholder API للحصول على أول ٥ منشورات: GET https://jsonplaceholder.typicode.com/posts?_limit=5"

طلب مع مصادقة

"تحقق من قاعدة Airtable باستخدام مفتاح API: GET https://api.airtable.com/v0/appXXXXX/Table1 مع Authorization: Bearer {{AIRTABLE_API_KEY}}"

طلب POST

"أنشئ مهمة جديدة في أداة إدارة المشاريع: POST https://api.example.com/tasks مع body { "title": "مراجعة العرض", "priority": "high" }"

طرق HTTP المدعومة

• GET — استرجاع البيانات

• POST — إنشاء موارد جديدة

• PUT — استبدال موارد موجودة

• PATCH — تحديث جزئي للموارد

• DELETE — حذف الموارد

أنواع الاستجابة

• JSON — بيانات منظمة (الافتراضي)

• Text — استجابات نص عادي

• Binary — تحميل ملفات

المهلة الزمنية

• الافتراضي: ٣٠ ثانية

• الحد الأقصى: ١٢٠ ثانية

أمثلة عملية

تكامل Airtable

"استخدم مفتاح Airtable API لعرض جميع السجلات في جدول 'المشاريع' ولخّص حالة كل مشروع."

Slack Webhook

"أرسل رسالة لقناة Slack الخاصة بفريقنا عبر webhook URL هذا: [رابط]. الرسالة: 'التقرير الأسبوعي جاهز.'"

CRM مخصص

"تحقق من API الخاص بـ CRM لآخر الصفقات: GET https://api.ourcrm.com/deals?status=open مع مفتاح CRM API."

خدمة الطقس

"استخدم OpenWeatherMap API للحصول على توقعات ٥ أيام لدبي."

دمج واجهات API

"تحقق من سعر سهم أرامكو باستخدام API المالي، ثم انشر النتيجة في قناة Slack عبر webhook."

حدود الخطة

الخطة	أدوات المتجر (بما فيها أدوات API)
مجانية	١
أساسية	٥
بلس	١٥
برو	غير محدود

الأمان

• بيانات الاعتماد مشفرة في حالة السكون (AES-256-GCM)

• مفاتيح API لا تظهر أبداً في ردود المحادثة

• نظام العناصر النائبة {{KEY_NAME}} يضمن أن المفاتيح تُدخل فقط وقت التنفيذ

• يمكنك حذف بيانات الاعتماد المخزّنة في أي وقت من الإعدادات

نصائح

• ابدأ بسيطاً: اختبر بطلب GET أساسي قبل بناء سير عمل معقدة

• تحقق من وثائق API: تأكد من معرفة صيغة النقطة النهائية والعناوين المطلوبة

• استخدم مع المهام المجدولة: ادمج استدعاءات API مع المهام المجدولة للمراقبة الآلية

• سلسلة الطلبات: يمكنك طلب عدة استدعاءات API متتابعة — مثلاً "احصل على بيانات من API أ، عالجها، ثم أرسل النتيجة إلى API ب"