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

ثبت مقدار فیلدها روی چند فایل

PUT 

/api/v1/IOService/CustomFields/Files

مقدارهای یکسان فیلدهای سفارشی را روی چند فایل از یک پوشه اعمال می‌کند (همان «اعمال روی همه» در برنامه‌ی وب).

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

بدنه‌ی درخواست: { "fileIds": ["..."], "values": { "<key>": <value> } }. همه‌ی فایل‌ها باید در یک پوشه باشند. حداکثر ۵۰ فایل در هر درخواست (قابل تنظیم روی سرور).

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

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

درخواست​

پاسخ‌ها​

OK