حالة إنشاء Felo

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

تستخدم جميع الأمثلة FELO_API_KEY من نظرة عامة. تستخدم الاستدعاءات رصيد المنصة، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.

استخدم المعرفات المُعادة عند إنشاء المهمة. اضبط TASK_ID على task_id وPPT_ID على ppt_business_id؛ كما يعني {business_id} أيضًا ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

2. استطلع حالة الإنشاء

GET /api/v1/data/tasks/{task_id}/status

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/status" \
  -H "Authorization: Bearer $FELO_API_KEY"

تحتوي الاستجابة على سلسلة status في الجذر، مثل RUNNING أو COMPLETED. استطلع ضمن فاصل زمني محدود (مثلًا، 2–5 ثوانٍ) ومع مهلة نهائية. واصل إلى النتائج بعد الاكتمال؛ وتعامل مع الفشل والحالات غير المتوقعة دون افتراض النجاح. لا يؤدي تحديد مهلة للاستطلاع إلى إلغاء المهمة.

{"status":"COMPLETED"}

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

• تنتهي صلاحية العروض التقديمية بعد سبعة أيام من الإنشاء. لا تؤدي الاستعلامات والتصديرات إلى تمديد هذه المدة. يصف expires_at الخاص بالعرض التقديمي وexpires_at الخاص برابط التنزيل الموقّع مددًا مختلفة.
• لا يمكن الوصول إلى المهام والعروض التقديمية إلا عبر حساب API المنشئ لها. قد يؤدي مورد مفقود أو غير متاح إلى 404؛ وقد يؤدي مورد منتهي الصلاحية أو محذوف إلى 410، أو 404 بعد التنظيف.
• يُفوتر الإنشاء لكل صفحة مُنشأة (ppt.generate). وبموجب تسعير الصفحات، يحجز الإنشاء سعر عشر صفحات، ثم يسوّي المخرجات الناجحة الفعلية ويُحرر الحجز غير المستخدم. يحتاج حسابك إلى رصيد متاح كافٍ للحجز حتى لو طلب النص صفحات أقل.
• للتصدير سعر طلب منفصل (ppt.export). استعلامات الحالة، واستعلامات النتائج، واستعلامات حالة التصدير، والحذف لا تنشئ رسومًا جديدة.
• بعد انتهاء المهلة، استعلم عن المهمة المحفوظة بدلًا من إنشاء عرض آخر. راجع الفوترة والأخطاء.