الانتقال إلى المحتوى الرئيسي
DELETE
احذف التقرير التنظيمي نهائياً.

ما الذي يُحذف

يُحذف التقرير، وما يتضمنه من السرد المنسوخ والأسباب وسائر حقول التقرير، وروابطه بالمعاملات، وملفَي goAML XML وPDF اللذين أُنشئا له. تُمحى كل نسخة مخزَّنة من هذه الملفات. يختفي التقرير من قوائم التقارير، وتتوقف روابط التنزيل التي صدرت سابقاً عن العمل. لا تُحذف الحالة والمعاملات والأشخاص والشركات. فالتقرير لا يأخذ بياناتها معه. الحذف نهائي ولا يمكن التراجع عنه.

التأكيد

يُحذف التقرير إذا كان مسودة أو تم التحقق من صحته، دون جسم للطلب. يتطلب حذف التقرير الذي تم إنهاؤه تأكيداً صريحاً:
ومن دون هذا التأكيد تعيد الواجهة الاستجابة 400 ولا يُحذف شيء.

إذا تعذّر محو الملفات الآن

تعني الاستجابة 503 مع code: report_storage_unavailable أن ملفات التقرير تعذّر محوها في الوقت الحالي. التقرير ما زال قائماً، لذا أعد الطلب. وتعني الاستجابة 409 مع code: report_deletion_pending أن عملية حذف لهذا التقرير قيد التنفيذ بالفعل: أعد الطلب لإتمامها.

حل حذف محظور

إذا أعاد حذف شخص أو شركة أو معاملة أو حالة أو جلسة الاستجابة 409 مع code: in_filed_report، فإن الاستجابة تسمّي التقارير التي تحتفظ بالبيانات. احذف كل تقرير من هنا، ثم أعد طلب الحذف المحظور.

ذو صلة

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

organization_id
string<uuid>
مطلوب

UUID الخاص بالمؤسسة.

application_id
string<uuid>
مطلوب

معرّف UUID للتطبيق.

report_uuid
string<uuid>
مطلوب

معرّف UUID للتقرير.

مثال:

"5ec00000-0000-4000-8000-000000000007"

الجسم

application/json

مطلوب فقط للتقرير النهائي.

confirm_delete
boolean

يُضبط على true لتأكيد حذف التقرير النهائي وملفاته المنشأة نهائياً.

الاستجابة

تم حذف التقرير، بما في ذلك ملفاته المُنشأة.

آخر تعديل في ٧ نوفمبر ٢٠٢٦