رفع ملفات الإثبات اللازمة للتسجيل

ارفع الملفات قبل إرفاقها

ارفع ملفات فئة واحدة من الإثباتات أو المستندات الداعمة، ثم أرفق معرّفات الملفات المُعادة باستخدام create_proof أو create_supporting_document. الرفع وحده لا ينشئ هوية أو عنوانًا أو إثباتًا، ولا يُكمل تسجيل رقم. ابدأ بالاطلاع على المتطلبات الحالية ومعرّفات الكتالوج.

قدّم مُحدِّدًا واحدًا فقط: proof_type_id لإثبات الهوية أو العنوان، أو supporting_template_id لمستند داعم. لا ترسل كليهما. استخدم المعرّفات التي يعيدها كتالوج MultiTEL المعني؛ وتعامل معها كمعرّفات لا يُستدل من بنيتها على أي معنى.

طلب الرفع

استخدم حسابًا مفعّلًا لواجهة API الخاصة بـ MultiTEL وعنوان IP المسموح به لهذا الحساب. تستخدم الأمثلة بيانات اعتماد مصادقة HTTP Basic من متغيرات البيئة؛ اتبع قواعد المصادقة الخاصة بنوع حسابك. أرسل الطلبات عبر HTTPS. تحقّق من استجابة HTTP ومن حقل JSON status.code؛ فقد تُعاد أخطاء التطبيق مع حالة HTTP 200. الأمثلة أدناه افتراضية.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

حدود الملفات

يقبل هذا المعالج خمسة ملفات على الأكثر، بحجم إجمالي لا يتجاوز 20,000,000 بايت. هذا حد بالبايت وفق النظام العشري، وليس 20 MiB. قد تفرض البنية التحتية أو عملية التحقق من MIME حدودًا إضافية.

قائمة الامتدادات المسموح بها هي pdf، png، jpg، jpeg، gif، tiff، bmp، doc، docx، xls، xlsx، txt، rtf و csv. وجود امتداد مسموح به لا يثبت أن الملف يستوفي متطلب التسجيل المحدد. وعلى وجه الخصوص، فإن tif غير موجود في قائمة الامتدادات المسموح بها هذه.

تحقّق من كل ملف مُعاد

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

احتفظ بكل response.ids[].id لاستخدامه في طلب الإرفاق. الحقل name يحدد اسم الملف المصدر المُعاد. استخدم أسماء ملفات متميزة وقارن الملفات المُعادة بالمجموعة المتوقعة: فقد يشير الرمز 200 إلى نجاح جزئي لدفعة الملفات. لا تُرفق مجموعة تنقصها ملفات مطلوبة.

entity_type تكون قيمته identities أو addresses للإثبات، و supporting_documents لرفع ملفات داعمة. الحقل document_category تكون قيمته proof أو supporting. أما الحقل ذو الاسم العام proof_type في الاستجابة، فيحمل أيضًا مرجعًا للقالب عند رفع ملفات داعمة؛ احتفظ بقيمة supporting_template_id الأصلية لاستخدامها عند الإرفاق.

أرفق الملفات دون تأخير

تحدد الخدمة وقت انتهاء الصلاحية بعد نحو 20 دقيقة من تخزين الملف المرفوع محليًا. تتحقق عملية الإرفاق من أن الملف يتبع الحساب نفسه، ولم يُعلَّم بأنه منتهي الصلاحية، ولم يحِن وقت انتهاء صلاحيته بعد، وينتمي إلى فئة الكيان الصحيحة. الحقل expired_at لا يتضمن إزاحة للمنطقة الزمنية في هذه الاستجابة؛ فلا تفترض أنه بتوقيت UTC. أرفق الملفات دون تأخير بدلًا من جدولة العملية عند حد انتهاء الصلاحية.

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

الأخطاء وإعادة المحاولة

يستخدم المعالج الحالي رمز API 404 عند عدم تقديم أي ملفات مستندات، والرمز 500 لأخطاء التحقق من الوصف، أو المُحدِّدات المفقودة أو المتعارضة، أو معرّفات الإثبات أو القالب غير الصالحة، أو تجاوز حد عدد الملفات أو حجمها الإجمالي، أو مشكلات التخزين، أو فشل الرفع. اقرأ status.msg؛ فلا يُعبَّر عن المدخلات غير الصالحة دائمًا بالرمز 400.

لا يُتاح هنا مفتاح للعميل يضمن عدم تكرار أثر الطلب عند إعادته. إذا فُقدت الاستجابة، فتحقّق من سير عمل المستندات قبل تكرار الرفع؛ فقد ينشئ طلب آخر مراجع ملفات جديدة. لم تُنفَّذ هذه الأمثلة باستخدام مستندات هوية العملاء.