# حالة تصدير Felo

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

أنشئ عرضًا تقديميًا بشكل غير متزامن، ثم صدّر ملف PPTX. افصل بين مرحلتي الإنشاء والتصدير: فالمهمة المُنشأة ليست ملفًا مكتملًا بعد.

تستخدم جميع الأمثلة `FELO_API_KEY` من [نظرة عامة](https://openapi.felo.ai/ar/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"
}
```

رابط المثال توضيحي. استخدم رابط التوقيع الفعلي من الاستجابة. وهو صالح لمدة **30 دقيقة**; يمكن لاستعلام حالة التصدير عبر GET أن يعيد رابطًا جديدًا بينما يظل العرض التقديمي متاحًا. احفظ الملف ضمن فترة صلاحيته. لا ترسل مفتاح Felo API الخاص بك إلى مضيف تنزيل الملف.



## المدة والملكية والفوترة

- تنتهي صلاحية العروض التقديمية **بعد سبعة أيام من الإنشاء**. لا تؤدي الاستعلامات والتصديرات إلى تمديد هذه المدة. يصف `expires_at` الخاص بالعرض التقديمي و`expires_at` الخاص برابط التنزيل الموقّع مددًا مختلفة.
- لا يمكن الوصول إلى المهام والعروض التقديمية إلا عبر حساب API المنشئ لها. قد يؤدي مورد مفقود أو غير متاح إلى 404؛ وقد يؤدي مورد منتهي الصلاحية أو محذوف إلى 410، أو 404 بعد التنظيف.
- يُفوتر الإنشاء لكل صفحة مُنشأة (`ppt.generate`). وبموجب تسعير الصفحات، يحجز الإنشاء سعر عشر صفحات، ثم يسوّي المخرجات الناجحة الفعلية ويُحرر الحجز غير المستخدم. يحتاج حسابك إلى رصيد متاح كافٍ للحجز حتى لو طلب النص صفحات أقل.
- للتصدير سعر طلب منفصل (`ppt.export`). استعلامات الحالة، واستعلامات النتائج، واستعلامات حالة التصدير، والحذف لا تنشئ رسومًا جديدة.
- بعد انتهاء المهلة، استعلم عن المهمة المحفوظة بدلًا من إنشاء عرض آخر. راجع [الفوترة والأخطاء](https://openapi.felo.ai/ar/docs/data-api/guides/felo-billing.md).