عرض مراجع الرفع المتاحة
استخدم نقطة النهاية هذه بعد رفع مستندات التسجيل عندما تحتاج إلى العثور على مراجع لا تزال متاحة للإرفاق. استخدم حساب API مفعلا لدى MultiTEL عبر HTTPS مع بيانات الاعتماد وقيود عناوين بروتوكول الإنترنت المهيأة له. تقتصر القائمة على حسابك.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesلا يلزم إرسال متن للطلب أو معاملات استعلام. يعرض المعالج سجلات الرفع المنشأة عبر API التي لم يتم تفعيل علامة انتهاء الصلاحية فيها والتي يقع وقت انتهاء صلاحيتها بعد الوقت الحالي للخادم. ولا يوفر معاملات لتقسيم النتائج إلى صفحات أو للبحث أو الفرز. وهذه ليست قائمة بجميع الهويات أو مستندات الإثبات أو المستندات السابقة في حسابك.
قراءة البيانات الوصفية، لا بايتات المستندات
اقرأ نتيجة HTTP والحقل status.code ضمن بيانات JSON. تحتوي الاستجابة الناجحة على مصفوفة في response؛ وتكون النتيجة الفارغة مصفوفة فارغة، وليست خطأ يشير إلى عدم وجود الحساب. يستخدم المثال بيانات وصفية ومعرفات وهمية.
{
"status": {"code": 200, "msg": ""},
"response": [{
"id": "0123456789abcdef0123456789abcdef",
"proof_type": "abcdef0123456789abcdef0123456789",
"entity_type": "addresses",
"description": "Example address proof",
"file_name": "example-document.pdf",
"date": "2026-10-01 12:00:00"
}]
}| الحقل | المعنى |
|---|---|
id | المرجع الخارجي للرفع. انسخه كما هو تماما لاستخدامه في طلب الإرفاق المعني. لا تحسب معرفا بنفسك ولا تستبدله بمعرف هوية أو عنوان أو قالب. |
proof_type | مرجع النوع المسجل بصيغته المقنعة إن وجد، وإلا فسلسلة نصية فارغة. بالنسبة إلى ملفات الإثبات المرفوعة، يمثل هذا نوع الإثبات؛ أما المستندات الداعمة المرفوعة فتسجل مرجع قالبها تحت المفتاح نفسه. اقرأ entity_type للتمييز بينها. هذا ليس معرف الرفع. |
entity_type | فئة الإرفاق المسجلة، مثل identities أو addresses أو supporting_documents. اختر سير عمل الإرفاق المطابق. |
description | الوصف المخزن للملف المرفوع. |
file_name | اسم الملف الأصلي. هذا ليس عنوانا لتنزيل الملف. |
date | وقت الإنشاء المسجل، بتنسيق يحدده الخادم دون إزاحة المنطقة الزمنية. |
لا تحتوي الاستجابة على بايتات المستندات أو عنوان التخزين أو موعد انتهاء الصلاحية. احتفظ بقيمة expired_at من استجابة الرفع الأصلية. لا يؤدي ظهور ملف مرفوع في القائمة إلى تمديد صلاحيته أو إرفاقه بهوية، ولا يثبت أن شركة اتصالات قد وافقت عليه.
إرفاق المستند قبل انتهاء صلاحية المرجع
استخدم سير العمل المناسب لعملية إرفاق مستند إثبات أو إرفاق مستند داعم. يمنح سير عمل الرفع الحالي المراجع فترة صلاحية قصيرة؛ فلا تؤخر الإرفاق لمجرد ظهور مرجع في هذه القائمة. قد تنتهي صلاحية المرجع أو يصبح غير متاح بين عرض القائمة والإرفاق. تعامل مع استجابة الإرفاق بدلا من افتراض نجاحه.
إذا كانت القائمة فارغة على غير المتوقع، فتحقق من الحساب ومما إذا كانت صلاحية الرفع قد انتهت أو كان قد تم عبر سير عمل آخر. لا ترفع المستندات نفسها مجددا بشكل تلقائي دون التحقق من نتائج الرفع الأصلي والإرفاق.
الخصوصية
قد تكشف أسماء الملفات وأوصافها عن هوية أشخاص أو مستندات رغم عدم وجود محتويات الملفات. قيد الوصول وتجنب تسجيل الاستجابات كاملة في السجلات. لإزالة مرجع رفع محلي غير مستخدم، راجع إزالة مرجع رفع؛ فهذه العملية ليست خدمة شاملة لمحو المستندات.