باز کردن فایل فشرده
POST/api/v1/boxes/unzip
باز کردن یک فایل zip داخل یک پوشه را بهصورت ناهمگام شروع میکند.
دسترسی: کاربر واردشده با حق WRITE، فقط در فضای خودش.
بدنهی درخواست: zipBox (پوشهی فایل zip)، zipAlias (نام فایل zip) و extractBox (پوشهی مقصد) الزامیاند؛ password برای فایلهای رمزدار.
رفتار ناهمگام: اگر فایل رمزدار باشد، رمز پیش از شروع بهصورت همگام بررسی میشود تا رمز اشتباه فوراً خطا بدهد. سپس پاسخ موفق 201 بدون بدنه است و پیشرفت از راه فهرست کارها (GET /api/v1/io-audits/...) قابل پیگیری است.
نکته: این عملیات به مجوز وابسته است (قابلیت unzip)؛ در غیر این صورت 402 با code: LICENCE_RESTRICTED.
نام پوشه: هیچ بخشی از نام یا مسیر پوشه نمیتواند خالی، . یا .. باشد یا با .vc تمام شود؛ در این صورت پاسخ 400 است. نامهایی که فقط نقطه دارند (مثل v1.2) مجازند.
ورودیهای ردشده: فایلهایی از درون فایل فشرده که نامشان این قاعده را نقض کند یا یکی از نویسههای \ / ? % * : | " < > را داشته باشد، باز نمیشوند و بقیهی فایلها باز میشوند.
درخواست
پاسخها
- 200
- 401
Unauthorized