تخطَّ إلى المستندات
API

احذف مساحة العمل

يحذف مساحة العمل التي ينتمي إليها المفتاح أو التطبيق، بكل ما فيها، ويلغي خطتها.

DELETE/workspaces/{id}

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

DELETE /workspaces/{id}

يحذف مساحة العمل التي ينتمي إليها المفتاح أو التطبيق، بكل ما فيها، ويلغي خطتها.

مثال

يتطلب account:write. confirm هو اسم مساحة العمل، كما يطلب التطبيق من الشخص كتابته قبل الحذف. ولا تهم حالة الأحرف ولا المسافات حوله.

curl
curl -X DELETE "$OE/workspaces/6d2f8a41-9c3e-4b7a-8e15-2f0c9d4b7a63?confirm=Acme%20Support" -H "$AUTH"
الاستجابة
{  "object": "workspace",  "id": "6d2f8a41-9c3e-4b7a-8e15-2f0c9d4b7a63",  "deleted": true,  "activeWorkspaceId": "10417196-e324-4283-af98-66ec62167c47"}

الحذف نهائي: تذهب معها نطاقات مساحة العمل وعناوينها وبريدها وأعضاؤها ومفاتيحها، ويتوقف المفتاح الذي أجرى الاستدعاء عن العمل.

لا يُقبل إلا معرّف مساحة العمل التي ينتمي إليها المفتاح أو التطبيق، وأي معرّف آخر يُرجع 404. ويُرفض رمز الوصول الذي يعمل نيابةً عن عضو بـ 403 owner_only، والمفتاح أو التطبيق المقيّد بعناوين أو نطاقات معيّنة بـ 422 capability_unsupported.

لا يمكن حذف أول مساحة عمل أنشأها الحساب (409 first_workspace)، لذا احذف الحساب كله في التطبيق بدلًا من ذلك. والمساحة التي يُنقل إليها نطاق أو منها تُرجع 409 domain_moving.

قيمة confirm الخاطئة أو المفقودة تُرجع 422 invalid_parameter على confirm، وتسمّي الرسالة مساحة العمل.

يحتاج رمز وصول OAuth إلى رمز تحقق لهذا الاستدعاء. وإلى أن يتحقق التطبيق من رمز خلال آخر 60 دقيقة، يردّ الاستدعاء بـ 403 step_up_required ولا يغيّر شيئًا. ولا يُطلب ذلك من مفتاح API أبدًا. وتبيّن صفحة المصادقة كيف تطلب رمزًا وتتحقق منه.

المرجع