حذف الملفات دفعةً واحدة
يحذف حتى 100 ملف في استدعاء واحد، كلًّا منها كما يحذف `DELETE /files/{id}` ملفًا واحدًا، كما يفعل تحديد عدة ملفات في صفحة الملفات.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /files/batch-delete
يحذف حتى 100 ملف في استدعاء واحد، كلًّا منها كما يحذف DELETE /files/{id} ملفًا واحدًا، كما يفعل تحديد عدة ملفات في صفحة الملفات.
مثال
يتطلب threads:write. يأخذ ids من 1 إلى 100 معرّف ملف، وأي حقل آخر يعطي 422 unknown_parameter.
curl -X POST "$OE/files/batch-delete" -H "$AUTH" -H 'content-type: application/json' -d '{ "ids": ["file_0c4e7a91d2b84f63a5e19b7d", "file_6bb640f5b99e47deb758f1f5", "file_9e2b41c7a0f35d8e6b1c4a72"]}'{ "object": "file_batch_delete", "deleted": ["file_0c4e7a91d2b84f63a5e19b7d"], "kept": [ { "id": "file_6bb640f5b99e47deb758f1f5", "filename": "invoice-0912.pdf", "usage": "received", "reason": "It came in on a message, so it stays with that message." } ], "missing": ["file_9e2b41c7a0f35d8e6b1c4a72"]}الاستدعاء الذي تُحذف فيه بعض الملفات ويبقى غيرها ليس خطأً. يسرد deleted ما حُذف، وkept كل ملف قيد الاستخدام مع usage الخاص به وreason بالكلمات، وmissing المعرّفات المجهولة أو المحذوفة من قبل أو الواقعة خارج العناوين التي يحملها مفتاح مقصور.
يُفحص كل ملف من جديد لحظة حذفه، فالملف الذي صار قيد الاستخدام بعد أن سردته يُبقى عليه بدل أن يضيع. ولا يوجد تراجع.