# وضعیت خروجی Felo

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

یک ارائه را به‌صورت غیرهمزمان تولید کنید، سپس یک فایل PPTX خروجی بگیرید. مراحل تولید و خروجی را جدا نگه دارید: یک وظیفه ایجادشده هنوز یک فایل نهایی نیست.

تمام نمونه‌ها از `FELO_API_KEY` از [نمای کلی](https://openapi.felo.ai/fa/docs/data-api/guides/felo-overview.md) استفاده می‌کنند. تماس‌ها از **موجودی پلتفرم** استفاده می‌کنند، نه اعتبارات Felo Pro. نمونه‌های پاسخ صرفاً نمایشی هستند؛ محتوای زنده و فیلدهای اختیاری متفاوت‌اند.



از شناسه‌هایی که هنگام ایجاد وظیفه بازگردانده می‌شوند استفاده کنید. `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 می‌تواند پیوند تازه‌ای بازگرداند در حالی که ارائه همچنان در دسترس است. فایل را در طول عمر آن ذخیره کنید. کلید API Felo خود را برای میزبان دانلود فایل ارسال نکنید.



## چرخه عمر، مالکیت و صورتحساب

- ارائه‌ها **هفت روز پس از ایجاد** منقضی می‌شوند. پرس‌وجوها و خروجی‌ها این دوره را تمدید نمی‌کنند. `expires_at` ارائه و `expires_at` URL امضاشده دانلود، دو چرخه عمر متفاوت را توصیف می‌کنند.
- فقط حساب API ایجادکننده می‌تواند به وظایف و ارائه‌های خود دسترسی داشته باشد. یک منبع مفقود یا غیرقابل‌دسترسی می‌تواند 404 برگرداند؛ یک منبع منقضی‌شده یا حذف‌شده می‌تواند 410 یا پس از پاک‌سازی 404 برگرداند.
- تولید بر اساس هر صفحه تولیدشده (`ppt.generate`) صورتحساب می‌شود. در قیمت‌گذاری صفحه‌ای، ایجاد قیمت ده صفحه را رزرو می‌کند، سپس خروجی موفق واقعی را تسویه می‌کند و رزرو استفاده‌نشده را آزاد می‌سازد. حساب شما حتی اگر پرسش صفحات کمتری را درخواست کند، باید موجودی در دسترس کافی برای رزرو داشته باشد.
- خروجی یک قیمت درخواست جداگانه دارد (`ppt.export`). پرس‌وجوهای وضعیت، پرس‌وجوهای نتیجه، پرس‌وجوهای وضعیت خروجی و حذف هیچ هزینه جدیدی ایجاد نمی‌کنند.
- پس از یک زمان‌اِتمام، به‌جای ایجاد یک ارائه دیگر، وظیفه ذخیره‌شده را پرس‌وجو کنید. به [صورتحساب و خطاها](https://openapi.felo.ai/fa/docs/data-api/guides/felo-billing.md) مراجعه کنید.