Landing Page Task API

API zadań Landing Page zapewnia asynchroniczne możliwości generowania stron docelowych. Najpierw tworzysz zadanie, a następnie wykorzystujesz istniejące interfejsy API odpytywania zadań do sprawdzania postępu i wyników.

Uwierzytelnianie

Wszystkie żądania wymagają klucza API w nagłówku Authorization:

Authorization: Bearer YOUR_API_KEY

Użycie z agentami AI

Zainstaluj kompletny pakiet felo-ai, aby agent generował strony docelowe i używał każdego innego dostępnego Felo Skill. Instalator dynamicznie wykrywa każdy katalog pakietu zawierający SKILL.md, zamiast opierać się na stałej liście. Zainstaluj wszystkie wykryte Skills w Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills lub Hermes Agent ~/.hermes/skills. Przeczytaj podręcznik konfiguracji agenta AI, aby poznać kroki konfiguracji klucza API i weryfikacji dla poszczególnych platform.

Tworzenie zadania strony docelowej

Endpoint

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

Nagłówki żądania

Treść żądania

Przykład

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

Tworzenie z plikiem

Użyj multipart/form-data, aby przesłać jeden plik wraz z żądaniem zadania Landing Page. Plik jest najpierw przesyłany jako zasób LiveDoc, a następnie jego identyfikator zasobu jest przekazywany do zadania 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]'

Opcjonalne części multipart:

Odpowiedź sukcesu (200)

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

Pola odpowiedzi

Odpytywanie stanu zadania

Zadania Landing Page wykorzystują te same interfejsy API odpytywania zadań co zadania PPT.

Endpoint

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

Przykład

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'

Sprawdzanie informacji historycznych zadania

Endpoint

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

Przykład

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'

Przykładowa odpowiedź AI_PAGE po ukończeniu

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

Wspólne przykłady odpowiedzi odpytywania i semantykę stanów znajdziesz w API zadań PPT.

Kody błędów