پرش به مطلب اصلی

تبدیل فایل اداری به PDF

POST 
/api/v1/IOService/File/Generate/Pdf

تبدیل یک فایل اداری (مانند .docx، .xlsx، .pptx، .odt، .rtf، .txt یا .html) را به PDF در صف می‌گذارد. فایل PDF کنار فایل اصلی در همان پوشه ذخیره می‌شود و نامش نام فایل اصلی همراه با زمان ساخت است.

دسترسی: کاربر واردشده با Authorization و x-container (مقدار container که GET /api/v1/services/current برمی‌گرداند). فایل باید در فضای همین مشترک باشد.

بدنه‌ی درخواست: id (شناسه‌ی فایل، GUID) و webhook (اختیاری: نشانی‌ای که نتیجه به آن فرستاده می‌شود).

رفتار ناهمگام: پاسخ 202 با { message, fileId, fileName, container }. پس از پایان، اگر webhook داده شده باشد، سرور یک POST با بدنه‌ی { Success, UserEmail, FileName, FileUrl, FileSize, Error, ProcessedAt, Action } به آن می‌فرستد که Action برابر PDF_GENERATION است.

خطاها: id خالی 400؛ نبودن Authorization یا ناهمخوانی x-container 401؛ نبودن x-container 400؛ فایل ناموجود یا بیرون از فضای مشترک 404.

نکته: پسوند پشتیبانی‌نشده در درخواست رد نمی‌شود؛ کار در صف ناموفق می‌شود و نتیجه فقط از طریق webhook معلوم است. در حال حاضر اگر هنگام صف‌گذاری خطای پیش‌بینی‌نشده‌ای رخ دهد هم پاسخ 202 است، با { message, error }.

حق نوشتن: این درخواست حق WRITE (یا ناظر بودن) روی حساب مشترک می‌خواهد؛ حساب فقط‌خواندنی پاسخ 403 می‌گیرد.

درخواست​

پاسخ‌ها​

OK