إزالة ملف تسجيل

إزالة ملف تسجيل عن قصد

تحاول هذه العملية القديمة حذف الهوية والعنوان المملوكين للحساب لدى مشغّل الاتصالات، ثم تضع علامة على الملف المحلي بأنه محذوف. حدّد المعرّف الفريد عالميًا (UUID) للملف المحلي الصحيح باستخدام documents وراجعه في البوابة قبل استدعاء هذه العملية. فهي ليست إزالة تقتصر على مستند الإثبات، ولا عملية تراجع.

طلب حذف قديم

صادِق باستخدام حسابك المفعّل لواجهة MultiTEL API من عنوان IP مسموح به. تستخدم الأمثلة بيانات اعتماد في متغيرات البيئة وبيانات وهمية. اقرأ الحقلين status.code وstatus.msg في JSON، بالإضافة إلى استجابة HTTP.

تستدعي البوابة الحالية هذه العملية باستخدام GET. ورغم طريقة HTTP المستخدمة، فإنها تغيّر البيانات. لا تستخدم عنوان URL مطلقًا في رابط أو صورة أو فحص سلامة أو جلب مسبق بواسطة المتصفح أو زاحف أو إعادة محاولة تلقائية. اشترط في تكاملك اتخاذ المستخدم قرارًا صريحًا بالحذف.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"

DOCUMENT_UUID هو معرّف الملف المحلي الذي يُعاد باسم uuid عند الإنشاء أو باسم id عند قراءة الملف مجددًا. وهو ليس معرّف الهوية أو معرّف العنوان أو رقم هاتف. لا يُستخدم جسم للطلب.

النتيجة المُبلّغ عنها

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": []
}

رمز API 404 المصحوب بالرسالة Failed, Not found يعني أنه لم يُعثر على المعرّف الفريد عالميًا (UUID) للملف لهذا الحساب. والإبلاغ عن الرمز 200 يعني أن المعالج وصل إلى استجابة الإكمال؛ ولا يثبت أن مشغّل الاتصالات حذف الهوية/العنوان أو أن تحديث قاعدة البيانات المحلية نجح.

التحقّق من الإزالة ونطاقها

لا يتحقّق المعالج الحالي من نتائج الحذف لدى مشغّل الاتصالات أو التحديث المحلي. بعد الإبلاغ عن النجاح، تأكّد من عدم ظهور الملف ضمن النتائج النشطة من documents ومن أن نتيجة الاستعلام عنه تشير إلى عدم العثور عليه عند استخدام get_document. تؤكّد هذه الفحوصات حالة ظهور الملف محليًا فقط. وهي لا تثبت الحذف لدى مشغّل الاتصالات المزوّد للخدمة في المنبع.

نقطة النهاية هذه ليست واجهة API عامة لمحو البيانات الشخصية. وهي لا تثبت حذف الملفات المرفوعة أو مستندات الإثبات أو المستندات الداعمة أو السجلات أو النسخ الاحتياطية أو غيرها من السجلات المحتفَظ بها. لتأكيد الإزالة لدى مزوّد الخدمة في المنبع أو لطلب محو البيانات، تواصل مع الدعم. لا تكرّر استدعاء الحذف بدلًا من التحقّق من نتيجة جزئية.