إعداد واجهة Felo API
المزود: Felo · مدفوع برصيد المنصة
Felo هو أحد المزودين في Data API، ويقدم بحث الويب وقراءة الويب وبيانات X وإجابات معتمدة على البحث والعروض التقديمية. اعثر على كل نقطة نهاية من نقاط Felo إلى جانب المزودين الآخرين ضمن فئة Data API ذات الصلة.
تستخدم هذه النقاط رصيد المنصة والبادئة /api/v1/data. يشرح هذا الدليل المصادقة، وطلبك الأول، وأين تجد قواعد الفوترة.
لاستخدام أرصدة Felo Pro، راجع واجهات Felo API الحالية. رصيد المنصة وأرصدة Pro منفصلان.
نفّذ طلبك الأول
- أنشئ مفتاحًا في Console → API Keys.
- تحقّق من رصيد المنصة أو أضف إليه في Console → Billing.
- اضبط المفتاح على خادمك أو في الصدفة المحلية:
export FELO_API_KEY="YOUR_API_KEY"أرسل Authorization: Bearer $FELO_API_KEY. كما يُقبل X-API-Key أيضًا؛ اختر طريقة مصادقة واحدة. تحتاج طلبات JSON إلى Content-Type: application/json.
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 لذلك.
استكشف واجهات API
| الدليل | العمليات | ما الذي تستلمه | وحدة الفوترة |
|---|---|---|---|
| بحث الويب | البحث في الويب | عناوين الصفحات والروابط والمقتطفات | الطلب |
| قراءة الويب | قراءة عنوان URL | Markdown أو نص أو HTML أو لقطة شاشة | الطلب |
| بيانات X | الملفات الشخصية، بحث المستخدمين، منشورات المستخدمين، بحث المنشورات، الردود | مستخدمون ومنشورات منظَّمون، مع ترقيم حيثما كان مدعومًا | نتيجة مُعادة |
| الدردشة المعتمدة على البحث | الإجابة عن سؤال | الإجابة ومصادر الويب | الطلب |
| PPT | إنشاء، حالة، نتائج، تصدير، حالة التصدير، حذف | مهمة إنشاء وملف PPTX قابل للتنزيل | الصفحة المُنشأة؛ يُفوتر التصدير بشكل منفصل |
| الفوترة والأخطاء | إرشادات التكامل المشتركة | الأسعار، والتعامل مع الرصيد، وقواعد إعادة المحاولة | — |
هناك 14 عملية أساسية عبر هذه الأدلة. إذا أعاد إنشاء PPT قيمة stream_key، يوضح دليل PPT أيضًا كيفية قراءة أحداث الإنشاء عبر 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 وفوترة أرصدة Pro.
العقد والأسعار الحالية
- مخطط OpenAPI المنشور — تعريفات الحقول ومخططات الاستجابة.
- مخطط OpenAPI بصيغة YAML — للأدوات التي تقبل YAML.
- الأسعار الحالية — معرّفات العمليات، ووحدات الفوترة، والأسعار الحالية.
هذه الموارد عامة ويمكن قراءتها بدون مفتاح. راجع الفوترة والأخطاء قبل إضافة إعادة المحاولة التلقائية.