# إعداد واجهة Felo API

أعد إعداد نقاط نهاية Felo في Data API للبحث ومحتوى الويب وبيانات X والعروض التقديمية، باستخدام رصيد المنصة.

Felo هو أحد المزودين في [Data API](https://openapi.felo.ai/ar/docs/data-api)، ويقدم بحث الويب وقراءة الويب وبيانات X وإجابات معتمدة على البحث والعروض التقديمية. اعثر على كل نقطة نهاية من نقاط Felo إلى جانب المزودين الآخرين ضمن فئة Data API ذات الصلة.

تستخدم هذه النقاط **رصيد المنصة** والبادئة `/api/v1/data`. يشرح هذا الدليل المصادقة، وطلبك الأول، وأين تجد قواعد الفوترة.

لاستخدام أرصدة Felo Pro، راجع [واجهات Felo API الحالية](https://openapi.felo.ai/ar/docs/api-reference/felo-apis.md). رصيد المنصة وأرصدة Pro منفصلان.

## نفّذ طلبك الأول

1. أنشئ مفتاحًا في [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. تحقّق من **رصيد المنصة** أو أضف إليه في [Console → Billing](https://openapi.felo.ai/console/billing).
3. اضبط المفتاح على خادمك أو في الصدفة المحلية:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

أرسل `Authorization: Bearer $FELO_API_KEY`. كما يُقبل `X-API-Key` أيضًا؛ اختر طريقة مصادقة واحدة. تحتاج طلبات JSON إلى `Content-Type: application/json`.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is retrieval augmented generation?","count":3}'
```

يعيد HTTP 200 مصفوفة `resources` مع عناوين الصفحات والروابط والمقتطفات، بالإضافة إلى `total`. لا يُنشئ إجابة حوارية؛ استخدم [Chat](https://openapi.felo.ai/ar/docs/data-api/guides/felo-chat.md) لذلك.

## استكشف واجهات API

| الدليل | العمليات | ما الذي تستلمه | وحدة الفوترة |
|---|---|---|---|
| [بحث الويب](https://openapi.felo.ai/ar/docs/data-api/guides/felo-web-search.md) | البحث في الويب | عناوين الصفحات والروابط والمقتطفات | الطلب |
| [قراءة الويب](https://openapi.felo.ai/ar/docs/data-api/guides/felo-web-read.md) | قراءة عنوان URL | Markdown أو نص أو HTML أو لقطة شاشة | الطلب |
| [بيانات X](https://openapi.felo.ai/ar/docs/data-api/guides/felo-x-data.md) | الملفات الشخصية، بحث المستخدمين، منشورات المستخدمين، بحث المنشورات، الردود | مستخدمون ومنشورات منظَّمون، مع ترقيم حيثما كان مدعومًا | نتيجة مُعادة |
| [الدردشة المعتمدة على البحث](https://openapi.felo.ai/ar/docs/data-api/guides/felo-chat.md) | الإجابة عن سؤال | الإجابة ومصادر الويب | الطلب |
| [PPT](https://openapi.felo.ai/ar/docs/data-api/guides/felo-ppt.md) | إنشاء، حالة، نتائج، تصدير، حالة التصدير، حذف | مهمة إنشاء وملف PPTX قابل للتنزيل | الصفحة المُنشأة؛ يُفوتر التصدير بشكل منفصل |
| [الفوترة والأخطاء](https://openapi.felo.ai/ar/docs/data-api/guides/felo-billing.md) | إرشادات التكامل المشتركة | الأسعار، والتعامل مع الرصيد، وقواعد إعادة المحاولة | — |

هناك **14 عملية أساسية** عبر هذه الأدلة. إذا أعاد إنشاء PPT قيمة `stream_key`، يوضح [دليل PPT](https://openapi.felo.ai/ar/docs/data-api/guides/felo-ppt.md#sse) أيضًا كيفية قراءة أحداث الإنشاء عبر SSE. استعلامات الحالة والنتائج، واستعلامات حالة التصدير، والحذف لا تنشئ رسومًا جديدة.

## قبل نقل تكامل موجود

استخدم الدليل الخاص بالنقطة الدقيقة التي تستدعيها. استبدال `/v2` بـ `/api/v1/data` ليس ترحيلًا كاملًا:

- تستخدم Web Read المسار `/web/read`، مع صيغة إخراج واحدة لكل طلب.
- تعيد Chat `status: "ok"`; وهي تدعم JSON غير المتدفق فقط.
- تستخدم نتائج PPT **POST** `/tasks/{task_id}/historical`.
- يعيد إنشاء PPT المعرفات في جذر JSON. احفظ كلًا من `task_id` و`ppt_business_id`.
- تنتهي صلاحية PPT المُنشأة بعد سبعة أيام. صدّر ملفك واحفظه قبل الانتهاء.

لا يوجد مكافئ OpenAPI أصلي موثق هنا لكل سير عمل `/v2`، مثل LiveDoc CRUD أو Mindmap أو SuperAgent. واصل استخدام [أدلة Felo APIs](https://openapi.felo.ai/ar/docs/api-reference/felo-apis.md) وفوترة أرصدة Pro.

## العقد والأسعار الحالية

- [مخطط OpenAPI المنشور](https://openapi.felo.ai/api/v1/data/openapi.json) — تعريفات الحقول ومخططات الاستجابة.
- [مخطط OpenAPI بصيغة YAML](https://openapi.felo.ai/api/v1/data/openapi.yaml) — للأدوات التي تقبل YAML.
- [الأسعار الحالية](https://openapi.felo.ai/api/v1/data/prices) — معرّفات العمليات، ووحدات الفوترة، والأسعار الحالية.

هذه الموارد عامة ويمكن قراءتها بدون مفتاح. راجع [الفوترة والأخطاء](https://openapi.felo.ai/ar/docs/data-api/guides/felo-billing.md) قبل إضافة إعادة المحاولة التلقائية.