# סטטוס ייצוא של Felo

GET /api/v1/data/ppts/{business_id}/export

צרו מצגת באופן אסינכרוני, ואז ייצאו קובץ PPTX. הפרידו בין שלב היצירה לשלב הייצוא: משימה שנוצרה עדיין אינה קובץ גמור.

כל הדוגמאות משתמשות ב-`FELO_API_KEY` מתוך [הסקירה הכללית](https://openapi.felo.ai/he/docs/data-api/guides/felo-overview.md). הקריאות משתמשות ב-**יתרת הפלטפורמה**, ולא ב-Felo Pro credits. דוגמאות התגובה הן להמחשה; תוכן חי ושדות אופציונליים משתנים.



השתמשו במזהים המוחזרים בעת יצירת המשימה. הגדירו `TASK_ID` ל-`task_id` ו-`PPT_ID` ל-`ppt_business_id`; `{business_id}` פירושו גם `ppt_business_id`.

```bash
TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"
```



## 5. שאילתת ייצוא והורדה

`GET /api/v1/data/ppts/{business_id}/export`

```bash
curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
```

| סטטוס | פעולה הבאה |
|---|---|
| `NOT_STARTED` | הגישו את הייצוא פעם אחת |
| `PROCESSING` | המתינו, ואז בצעו GET שוב |
| `COMPLETED` | קראו את `download_url` והורידו את הקובץ |
| `FAILED` | בדקו את השגיאה ואת מצב המשימה לפני הגשת ייצוא חדש |

```json
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}
```

כתובת ה-URL בדוגמה היא להמחשה. השתמשו ב-URL החתום בפועל מהתגובה. הוא תקף למשך **30 דקות**; סטטוס ייצוא ב-GET יכול להחזיר קישור חדש בעוד המצגת עדיין זמינה. שמרו את הקובץ בתוך משך חייו. אל תשלחו את מפתח ה-Felo API שלכם למארח הורדת הקובץ.



## משך חיים, בעלות וחיוב

- מצגות פגות **שבעה ימים לאחר היצירה**. שאילתות וייצואים אינם מאריכים תקופה זו. `expires_at` של המצגת ו-`expires_at` של URL ההורדה החתום מתארים משכי חיים שונים.
- רק חשבון ה-API שיצר יכול לגשת למשימות ולמצגות שלו. משאב חסר או לא נגיש יכול להחזיר 404; משאב שפג תוקפו או נמחק יכול להחזיר 410, או 404 לאחר ניקוי.
- היצירה מחויבת לפי עמוד שנוצר (`ppt.generate`). לפי תמחור עמודים, היצירה שומרת את המחיר של עשרה עמודים, ואז מסדירה את הפלט המוצלח בפועל ומשחררת את ההחזקה שלא נוצלה. לחשבון שלכם חייבת להיות יתרה זמינה מספקת עבור ההחזקה גם אם הפרומפט מבקש פחות עמודים.
- לייצוא יש מחיר בקשה נפרד (`ppt.export`). שאילתות סטטוס, שאילתות תוצאות, שאילתות סטטוס-ייצוא ומחיקה אינן יוצרות חיוב חדש.
- לאחר timeout, שאבו את המשימה השמורה במקום ליצור מצגת נוספת. ראו [חיוב ושגיאות](https://openapi.felo.ai/he/docs/data-api/guides/felo-billing.md).