إرفاق إثبات هوية أو عنوان

نفّذ هذه الخطوة بعد إنشاء الهوية أو العنوان ورفع الملفات المطلوبة لهما عبر create_encrypt_files باستخدام نوع الإثبات المحدد. استخدم معرّفًا ساريًا من get_proof_types، على أن يتطابق مع المتطلب وفئة الكيان.

احتفظ بالقيمتين identity_id وaddress_id اللتين تعيدهما create_document؛ فمعرّف UUID الخاص بالملف الشخصي مختلف. لا يزال توافق إرفاق إثبات العنوان لاحقًا بالملفات الشخصية المنشأة حديثًا قيد المراجعة. إذا رُفض العنوان، فتحقق من البوابة أو تواصل مع الدعم قبل إعادة المحاولة.

إنشاء الإثبات

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

حقول الطلب
الحقل	المعنى
`entity_type`	استخدم identities أو addresses. اختر الفئة المطابقة لكل من الكيان المستهدف والملفات المرفوعة.
`entity_id`	معرّف الهوية أو العنوان المملوك لحسابك. استخدم المعرّف الذي يعيده سير عمل المستندات لديك؛ ولا تستبدله برقم هاتف أو معرّف مستند غير ذي صلة.
`proof_type_id`	معرّف نوع الإثبات المحدد. احرص على توافقه مع الملفات المرفوعة والمتطلب.
`encrypted_file_ids`	مصفوفة JSON غير فارغة تضم معرّفات الملفات التي تعيدها create_encrypt_files. يجب أن تكون الملفات مملوكة للحساب نفسه، وألا تكون صلاحيتها قد انتهت، وأن تتطابق مع فئة الكيان. هذه ليست قائمة بمسارات ملفات محلية.

تُقبل أيضًا بيانات النموذج مع تكرار الحقل encrypted_file_ids[]. يُفضّل استخدام مصفوفة JSON فعلية أو مصفوفة حقول نموذج؛ ولا ترسل مصفوفة مرمّزة بصيغة JSON على هيئة قيمة مفردة عادية في النموذج.

الاحتفاظ بمعرّف الإثبات

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

تؤكد الاستجابة الناجحة إنشاء ارتباط الإثبات. ولا تؤكد الموافقة على الهوية أو العنوان، أو استيفاء جميع متطلبات البلد، أو تفعيل رقم هاتف.

الأخطاء والملفات المرفوعة المنتهية الصلاحية

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

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