Felo APIs

Landing Page Task API

צרו דפי נחיתה באופן אסינכרוני ושאלו על היסטוריית המשימות.

POST/v2/landing_page

אימות

Bearer API key

סוג תוכן

application/json or multipart/form-data

הערות תעריף

ייתכנו מגבלות ספציפיות ל-endpoint.

PPT Task API LiveDoc API

ה-Landing Page Task API מספק יכולות יצירת דפי נחיתה אסינכרוניות. אתם יוצרים משימה תחילה, ואז עושים שימוש חוזר בממשקי ה-API הקיימים לבדיקת משימות כדי לשאול על התקדמות ותוצאות.

אימות

כל הבקשות דורשות מפתח API בכותרת Authorization:

Authorization: Bearer YOUR_API_KEY

שימוש עם סוכני AI

התקינו את החבילה המלאה felo-ai כדי לאפשר לסוכן ליצור דפי נחיתה ולהשתמש בכל Felo Skill זמין אחר. המתקין מגלה באופן דינמי כל תיקיית חבילה שמכילה SKILL.md, במקום להסתמך על רשימה קבועה. התקינו את כל ה-Skills שהתגלו ב-Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills או Hermes Agent ~/.hermes/skills. קראו את מדריך ההגדרה הידנית לסוכני AI לשלבי מפתח ה-API והאימות הייחודיים לפלטפורמה.

יצירת משימת דף נחיתה

Endpoint

POST https://openapi.felo.ai/v2/landing_page

כותרות הבקשה

כותרת	חובה	תיאור
`Authorization`	כן	מפתח ה-API שלכם בפורמט `Bearer YOUR_API_KEY`
`Content-Type`	כן	`application/json` או `multipart/form-data`

גוף הבקשה

פרמטר	סוג	חובה	תיאור
`query`	string	כן	פרומפט לבקשת יצירת דף נחיתה
`stream_protocol`	string	לא	פרוטוקול זרם. ברירת מחדל: `message_center_v1`
`livedoc_short_id`	string	לא	מזהה מקוצר של LiveDoc קיים לשימוש כהקשר
`resource_ids`	array of strings	לא	מזהי משאבים של LiveDoc לשימוש כהקשר

דוגמה

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Generate a landing page for Felo Search"
  }'

יצירה עם קובץ

השתמשו ב-multipart/form-data כדי להעלות קובץ אחד עם בקשת משימת דף הנחיתה. הקובץ מועלה תחילה כמשאב LiveDoc, ואז מזהה המשאב שלו מועבר למשימת דף הנחיתה.

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'query=Generate a landing page from this product brief' \
  -F '[email protected]'

חלקי multipart אופציונליים:

פרמטר	סוג	חובה	תיאור
`stream_protocol`	string	לא	פרוטוקול זרם. ברירת מחדל: `message_center_v1`
`livedoc_short_id`	string	לא	מזהה מקוצר של LiveDoc קיים. אם הוא מושמט, נוצר LiveDoc חדש

תגובת הצלחה (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
  }
}

שדות התגובה

שדה	סוג	תיאור
`task_id`	string	מזהה משימה אסינכרונית לבדיקות חוזרות לאחר מכן

בדיקת מצב המשימה

משימות דף נחיתה עושות שימוש חוזר באותם ממשקי API לבדיקת משימות כמו משימות PPT.

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/status

דוגמה

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

שאילת מידע היסטורי על המשימה

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical

דוגמה

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/historical' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

דוגמת תגובת AI_PAGE שהושלמה

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019d7a4d-6ab5-a96d-0f98-43ca434ab621",
    "task_status": "COMPLETED",
    "ppt_biz_id": "9qiLTmT77fA3aVurrMHvRJ",
    "ppt_url": "https://felo.ai/slides/9qiLTmT77fA3aVurrMHvRJ",
    "ai_page_html": "https://felo.ai/ai-page/9qiLTmT77fA3aVurrMHvRJ"
  }
}

עיינו בPPT Task API לדוגמאות תגובת הבדיקה החוזרת המשותפות ולסמנטיקת הסטטוס.

קודי שגיאה

קוד	סטטוס HTTP	תיאור
`UNAUTHORIZED`	401	מפתח ה-API לא חוקי או בוטל
`LANDING_PAGE_TASK_CREATE_FAILED`	502	יצירת משימת דף הנחיתה נכשלה
`INSUFFICIENT_CREDITS`	402	אין מספיק קרדיטים זמינים