وضعیت تولید 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 URL امضاشده دانلود، دو چرخه عمر متفاوت را توصیف می‌کنند.
• فقط حساب API ایجادکننده می‌تواند به وظایف و ارائه‌های خود دسترسی داشته باشد. یک منبع مفقود یا غیرقابل‌دسترسی می‌تواند 404 برگرداند؛ یک منبع منقضی‌شده یا حذف‌شده می‌تواند 410 یا پس از پاک‌سازی 404 برگرداند.
• تولید بر اساس هر صفحه تولیدشده (ppt.generate) صورتحساب می‌شود. در قیمت‌گذاری صفحه‌ای، ایجاد قیمت ده صفحه را رزرو می‌کند، سپس خروجی موفق واقعی را تسویه می‌کند و رزرو استفاده‌نشده را آزاد می‌سازد. حساب شما حتی اگر پرسش صفحات کمتری را درخواست کند، باید موجودی در دسترس کافی برای رزرو داشته باشد.
• خروجی یک قیمت درخواست جداگانه دارد (ppt.export). پرس‌وجوهای وضعیت، پرس‌وجوهای نتیجه، پرس‌وجوهای وضعیت خروجی و حذف هیچ هزینه جدیدی ایجاد نمی‌کنند.
• پس از یک زمان‌اِتمام، به‌جای ایجاد یک ارائه دیگر، وظیفه ذخیره‌شده را پرس‌وجو کنید. به صورتحساب و خطاها مراجعه کنید.