# Landing Page Task API

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

עמוד זה מתעד את ה-Felo APIs הקיימים ב-`/v2`, תוך שימוש ב-**זכויות חשבון Felo וכללי Pro-credit**. האם זיכויים מנוכים תלוי ב-[פעולה](https://openapi.felo.ai/he/docs/faq/billing-and-credits.md#credit-rules-by-v2-capability). עבור קריאות עם יתרת הפלטפורמה, בחרו [נקודת קצה נתמכת של Felo OpenAPI](https://openapi.felo.ai/he/docs/api-reference/openapi/overview.md); צורות הבקשה והתגובה יכולות להשתנות.

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

## Use with AI Agents

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


## Authentication

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

```
Authorization: Bearer YOUR_API_KEY
```

## Create Landing Page Task

### Endpoint

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

### Request Headers

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

### Request Body

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | פרומפט לבקשת יצירת דף נחיתה |
| `stream_protocol` | string | No | פרוטוקול סטרים. ברירת מחדל: `message_center_v1` |
| `livedoc_short_id` | string | No | מזהה LiveDoc קצר קיים לשימוש כהקשר |
| `resource_ids` | array of strings | No | מזהי משאבי LiveDoc לשימוש כהקשר |

### Example

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

### Create With File

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

```bash
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 'file=@brief.pdf'
```

Optional multipart parts:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stream_protocol` | string | No | פרוטוקול סטרים. ברירת מחדל: `message_center_v1` |
| `livedoc_short_id` | string | No | מזהה LiveDoc קצר קיים. אם מושמט, נוצר LiveDoc חדש |

### Success Response (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
  }
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `task_id` | string | מזהה משימה אסינכרונית להמשך polling |

## Poll Task Status

משימות Landing Page משתמשות באותן APIs של polling משימות כמו משימות PPT.

### Endpoint

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

### Example

```bash
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'
```

## Query Task Historical Info

### Endpoint

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

### Example

```bash
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 Completed Response Example

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "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://api-ext-index-file.felo.ai/html/address?message_id=9qiLTmT77fA3aVurrMHvRJ"
  }
}
```

עיינו ב-[PPT Task API](https://openapi.felo.ai/he/api-reference/v2/ppt-tasks.html) עבור דוגמאות תגובת polling המשותפות וסמנטיקת הסטטוס.

## Error Codes

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