Felo API PlatformFelo API Platform

מדריכים

סקירת Data API

קראו ל-endpoints של צד שלישי דרך קידומת משותפת אחת, עם אימות וטיפול בבקשות עקביים.

ה-Data API הוא קטלוג של ממשקי API חיצוניים מאחורי מפתח Felo אחד. הוא נפרד מממשקי ה-/v2 של Felo עצמה ומה-Model API.

קידומת משותפת

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

המסמכים מציגים כל נקודת קצה כנתיב מלא שמתחיל ב-/v1/beta. השתמשו בנתיב הזה כפי שהוא על המארח; אל תוסיפו שוב את הקידומת המשותפת. לדוגמה, נקודת הקצה של חיפוש Tavily היא:

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

מציאת נקודת קצה

  • עיינו בספריית ה-API לפי ספק.
  • פתחו את מסמכי Data API לרשימת נקודות הקצה המלאה, הפרמטרים וסכימות התגובה.
  • השתמשו בתגיות של המסמכים כדי לעבור בין ספקים.

לכל ספק צורת בקשה משלו. השכבה המשותפת מאחדת אימות וניתוב, לא את גוף הבקשה. קראו את סכימת נקודת הקצה לפני שליחת בקשה.

אימות

השתמשו באחת מהכותרות:

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 ייחודי לספק; עקבו אחרי סכימת נקודת הקצה
דפדוףשמות שדות וסגנונות סמן משתנים בין נקודות קצה
שגיאותJSON עם status, code, message ו-request_id; פרטי הספק עשויים להופיע בהודעה
מגבלות קצבתלויות בנקודת הקצה ובספק; צפו ל-429 תחת עומס
חיובלפי קריאה, מאותו יתרת קרדיטים לשירות כמו Model API

טיפול בשגיאות

כשל אימות מחזיר את אותה מעטפת כמו שאר הפלטפורמה:

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

בכשל ברמת הספק, קראו את סטטוס ה-HTTP ואת ההודעה. תעדו בלוג את השיטה, הנתיב המלא, צורת גוף הבקשה ו-request_id. אל תתעדו בלוג את מפתח ה-API המלא.

ניסיונות חוזרים

נסו שוב תגובות 429 ו-5xx עם השהיה גדלה. אל תנסו שוב 400 או 401 ללא שינוי. חלק מפעולות הספק אינן בטוחות לחזרה; בדקו את נקודת הקצה לפני ניסיון חוזר של כתיבה.

מתי להשתמש ב-API של Felo במקום

השתמשו ב-Data API כשאתם צריכים מקור נתונים חיצוני מסוים. השתמשו ב-API של Felo כשאתם רוצים את תהליך העבודה של Felo עצמה:

קשור