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 في رأس Authorization:

Authorization: Bearer YOUR_API_KEY

الاستخدام مع وكلاء الذكاء الاصطناعي

ثبّت حزمة felo-ai الكاملة لتمكين وكيل من توليد صفحات الهبوط واستخدام كل مهارة Felo Skill أخرى متاحة. يكتشف المثبّت ديناميكيًا كل دليل حزمة يحتوي SKILL.md، بدلًا من الاعتماد على قائمة ثابتة. ثبّت كل المهارات المكتشفة في Codex ~/.codex/skills أو Claude Code ~/.claude/skills أو OpenClaw ~/.agents/skills أو Hermes Agent ~/.hermes/skills. اقرأ دليل إعداد وكيل الذكاء الاصطناعي اليدوي لخطوات مفتاح 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 لرفع ملف واحد مع طلب Landing Page. يُرفع الملف أولًا كمورد LiveDoc، ثم يُمرَّر معرّف المورد إلى مهمة Landing Page.

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	معرّف المهمة غير المتزامنة للاستطلاع اللاحق

استطلاع حالة المهمة

تعيد مهام Landing Page استخدام واجهات استطلاع المهام نفسها المستخدمة في مهام 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	أرصدة غير كافية