> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/ar/tools/api-integration.md).

# تكامل 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 ب"