Felo API PlatformFelo API Platform

الأدلة

نظرة عامة على Data API

استدعِ نقاط endpoint الخاصة بأطراف ثالثة عبر بادئة مشتركة واحدة، مع مصادقة ومعالجة طلبات متسقة.

Data API كتالوج لواجهات API خارجية خلف مفتاح Felo واحد. وهو منفصل عن واجهات /v2 الخاصة بـFelo وعن Model API.

البادئة المشتركة

https://openapi.felo.ai/v1/beta

يعرض المرجع كل endpoint كمسار كامل يبدأ بـ/v1/beta. استخدم ذلك المسار كما هو على المضيف؛ لا تضف البادئة المشتركة مرة أخرى. على سبيل المثال، endpoint بحث Tavily هو:

POST https://openapi.felo.ai/v1/beta/tavily/search

العثور على endpoint

  • تصفّح دليل API حسب المزوّد.
  • افتح مرجع Data API للحصول على قائمة endpoints الكاملة والمعاملات ومخططات الاستجابة.
  • استخدم وسوم المرجع للتنقل بين المزوّدين.

يحتفظ كل مزوّد بشكل طلبه الخاص. توحّد الطبقة المشتركة المصادقة والتوجيه، لا الحمولة. اقرأ مخطط endpoint قبل إرسال طلب.

المصادقة

استخدم أيًا من الرأسين:

Authorization: Bearer $FELO_API_KEY

أو:

X-API-Key: $FELO_API_KEY

أرسل Content-Type: application/json لنصوص JSON.

مثال على طلب

curl https://openapi.felo.ai/v1/beta/tavily/search \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is Felo AI?",
    "max_results": 3
  }'

يأتي شكل الاستجابة من المزوّد. لا تُوحَّد حقول مثل النتائج ومؤشرات ترقيم الصفحات والبيانات الوصفية عبر المزوّدين.

الاصطلاحات

الموضوعما تتوقعه
الحمولةJSON خاص بالمزوّد؛ اتبع مخطط endpoint
ترقيم الصفحاتتختلف أسماء الحقول وأنماط المؤشرات حسب endpoint
الأخطاءJSON يتضمن status وcode وmessage وrequest_id؛ وقد تظهر تفاصيل المزوّد في الرسالة
حدود المعدلخاصة بـendpoint والمزوّد؛ توقع 429 تحت الحمل
الفوترةلكل استدعاء، من رصيد أرصدة الخدمة نفسه المستخدم في Model API

معالجة الأخطاء

يعيد فشل المصادقة الغلاف نفسه المستخدم في بقية المنصة:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "..."
}

لفشل على مستوى المزوّد، اقرأ حالة HTTP والرسالة. سجّل طريقة HTTP والمسار الكامل وشكل نص الطلب وrequest_id. لا تسجّل مفتاح API الكامل.

إعادة المحاولة

أعد المحاولة لاستجابات 429 و5xx مع تراجع تدريجي. لا تعد المحاولة لاستجابات 400 أو 401 دون تغيير. بعض عمليات المزوّد ليست آمنة التكرار؛ تحقق من endpoint قبل إعادة محاولة عملية كتابة.

متى تستخدم Felo API بدلًا من ذلك

استخدم Data API عندما تحتاج إلى مصدر بيانات خارجي محدد. واستخدم Felo API عندما تريد سير عمل Felo نفسه:

ذو صلة