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

ذخیره‌ی فرم فیلدهای سفارشی پوشه

PUT 
/api/v1/IOService/CustomFields/Box/:boxId

فیلدهای سفارشی و مقدارهای پیش‌فرضِ خود پوشه را به‌طور کامل جایگزین می‌کند و فرم مؤثر ذخیره‌شده را برمی‌گرداند. فیلدهای به‌ارث‌رسیده از پوشه‌های بالاتر با این درخواست تغییر نمی‌کنند.

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

بدنه‌ی درخواست: classificationRequired (آیا تعیین سطح طبقه‌بندی برای فایل‌های این پوشه لازم است)، fields (هر فیلد: key، label، type، required، askSender، showToRecipients، showInFormView، settings، options) و defaults (مقدار پیش‌فرض بر اساس key).

خطاها: نقض قاعده‌ها یا سقف‌ها 400 با { error, code, limit, field, label, params } که فیلد و سقف مربوط را نشان می‌دهد؛ پوشه بیرون از فضای مشترک 404؛ اگر پوشه رمزگذاری‌شده و قفل باشد پاسخ 409 است؛ نبودن Authorization یا ناهمخوانی x-container با کاربر 401، نبودن x-container در درخواست 400، و نبودن حساب مشترک فعال 404.

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

درخواست​

پاسخ‌ها​

OK