Landing Page Task API

Landing Page Task API, asenkron landing page oluşturma yetenekleri sunar. Önce bir görev oluşturursunuz, ardından ilerlemeyi ve sonuçları sorgulamak için mevcut görev sorgulama API'lerini kullanırsınız.

Kimlik Doğrulama

Tüm istekler, Authorization başlığında bir API anahtarı gerektirir:

Authorization: Bearer YOUR_API_KEY

AI Ajanlarıyla Kullanım

Bir Ajanın landing page oluşturmasına ve mevcut diğer tüm Felo Skill'lerini kullanmasına olanak tanımak için eksiksiz felo-ai paketini yükleyin. Yükleyici, sabit bir listeye güvenmek yerine SKILL.md içeren her paket dizinini dinamik olarak keşfeder. Keşfedilen tüm Skill'leri Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills veya Hermes Agent ~/.hermes/skills dizinlerine yükleyin. Platforma özgü API anahtarı ve doğrulama adımları için manuel AI Ajanı kurulum kılavuzunu okuyun.

Landing Page Görevi Oluşturma

Endpoint

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

İstek Başlıkları

İstek Gövdesi

Örnek

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"
  }'

Dosyayla Oluşturma

Landing Page görevi isteğiyle birlikte bir dosya yüklemek için multipart/form-data kullanın. Dosya önce bir LiveDoc kaynağı olarak yüklenir, ardından kaynak kimliği Landing Page görevine aktarılır.

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]'

İsteğe bağlı multipart bölümleri:

Başarılı Yanıt (200)

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

Yanıt Alanları

Görev Durumunu Sorgulama

Landing Page görevleri, PPT görevleriyle aynı görev sorgulama API'lerini kullanır.

Endpoint

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

Örnek

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'

Görev Geçmiş Bilgilerini Sorgulama

Endpoint

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

Örnek

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 Tamamlanmış Yanıt Örneği

{
  "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"
  }
}

Ortak sorgulama yanıtı örnekleri ve durum anlamları için PPT Task API sayfasına bakın.

Hata Kodları