إزالة مرجع رفع غير مستخدم

اختيار مرجع رفع غير مستخدم

تزيل نقطة النهاية هذه سجل مرجع رفع تابعا لحسابك. لا تستخدمها إلا عندما تتأكد من أن المرجع لم يعد مطلوبا من أجل إرفاق إثبات أو إرفاق مستند داعم. وهي لا تحذف هوية التسجيل أو عنوانه.

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

طلب الإزالة عن قصد

استخدم حساب API مفعّلا لدى MultiTEL عبر HTTPS، مع بيانات الاعتماد وقيود عناوين IP المضبوطة له. استخدم POST حتى يتعامل تطبيقك مع هذه العملية بوصفها تغييرا مقصودا:

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef

لا يفرض المعالج الحالي قيدا على طريقة HTTP: فقد يؤدي طلب GET أيضا إلى الحذف. لا تعرض عنوان URL هذا كرابط عادي قابل للنقر أو صورة أو إشارة مرجعية أو هدف للمعاينة أو الجلب المسبق. اشترط إجراء إزالة صريحا في تطبيقك، ولا تعاود المحاولة تلقائيا.

تفسير النتيجة وحدودها

اقرأ كلا من نتيجة HTTP والحقل status.code في استجابة JSON. تكون استجابة النجاح المعتادة كما يلي:

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

يعني الرمز 404 من API المصحوب بـ Failed, Not found أن أيا من عمليتي البحث لم تعثر على مرجع مطابق لهذا الحساب. لذلك قد تؤدي إعادة الإزالة إلى إرجاع 404. تُحذف المسافات في بداية قيمة المسار ونهايتها. لا يجري هنا التحقق من أن المرجع لم تنته صلاحيته أو أنه غير مستخدم في خطوة أخرى، لذا راجع سير عملك قبل إزالته.

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

الإزالة ليست محوا كاملا للبيانات

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

بعد إزالة المرجع المحلي، قد تفشل خطوات الإرفاق اللاحقة التي تحتاج إليه. احتفظ بنتائج عمليات الإرفاق المكتملة بالفعل، واستخدم سير العمل المناسب لإدارة الهوية أو الإثبات عند تغيير معلومات التسجيل المقدمة.