تحديث ملف تسجيل

استبدال تفاصيل الملف القابلة للتعديل

حدّث ملف تسجيل موجودًا تابعًا للحساب باستخدام معرّف UUID المحلي الخاص به من create_document أو documents. تغيّر هذه العملية بيانات الحساب وبيانات مشغّل الاتصالات في النظام المنبع. ولا تغيّر نوع الهوية المخزّن Personal/Business، وليست طلب PATCH لتعديل بعض الحقول فقط.

طلب التحديث

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @registration-profile-update.json \
  "https://api.multitel.net/v3/update_document/$DOCUMENT_UUID"

{
  "first_name": "Example",
  "last_name": "Person",
  "phone_number": "12025550123",
  "email": "end-user@example.com",
  "city": "Example City",
  "postal_code": "00000",
  "address": "1 Example Street",
  "country": "US",
  "nationality": "US",
  "signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE",
  "id_number": "",
  "personal_tax_id": "",
  "birth_date": "",
  "description": "Example profile",
  "company_name": "",
  "company_reg_number": "",
  "incorporation_country": "",
  "vat_id": "",
  "address_description": ""
}

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

متطلبات حقول التحديث
الحقول	السلوك
first_name, last_name, city, postal_code, address	مطلوبة؛ بحد أقصى 64 محرفًا لكل منها.
phone_number	قيمة رقمية مطلوبة لا تقل عن ثمانية محارف؛ استخدم الأرقام بالصيغة الدولية مع تضمين رمز البلد.
signature	مطلوب. توفّر البوابة بايتات PNG مرمّزة بصيغة Base64 دون بادئة عنوان URL للبيانات.
country	قدّم رمز ISO لبلد العنوان من دليل التسجيل. يحدّد المعالج البلد المقابل لهذا الرمز، مع أن تحديث العنوان الذي تمت مراجعته لا يغيّر الارتباط بالبلد.
nationality	رمز ISO للبلد مطلوب لملف موجود من نوع Personal.
company_name, incorporation_country	مطلوبان لملف موجود من نوع Business؛ يجب ألا يتجاوز اسم الشركة 64 محرفًا، ويجب تحديد بلد التأسيس برمز ISO.
email	عنوان بريد إلكتروني صالح واختياري بحد أقصى 254 محرفًا. احذف الحقل من الطلب للحفاظ على بريد الاتصال الإلكتروني المخزّن؛ وأرسل قيمة فارغة لمسحه محليًا.
id_number, personal_tax_id, birth_date, description, company_reg_number, vat_id	أرسل القيم الحالية المقصودة. تأخذ القيم غير المرسلة قيمًا فارغة افتراضيًا، وقد تحل محل القيم المخزّنة الموجودة.

قد تتطلب قواعد التسجيل الخاصة بكل بلد معلومات أو تنسيقات إضافية. لا تُعِد تكوين تحديث كامل اعتمادًا على get_document وحده: فاستجابته المحدودة لا تتضمن محددات البلدان ولا email ولا معرّفات الكيانات. احتفظ ببياناتك المصدرية المصرّح لك باستخدامها أو استخدم محرّر المستندات في البوابة.

إعدادات متقدمة: إضافة مستندات إثبات رُفعت مسبقًا

تقبل المصفوفتان الاختياريتان identity_encryptfiles وaddress_encryptfiles مراجع نشطة تابعة للحساب من create_encrypt_files. طابِق فئة الكيان الخاصة بالملف المرفوع وأرسل الطلب قبل انتهاء صلاحية المرجع. يُرفق كل ملف في طلب إثبات مستقل، حتى إن كانت عدة ملفات تشترك في نوع الإثبات نفسه. لإثبات هوية يتألف من عدة ملفات، استخدم لاحقًا سير عمل إرفاق مستندات الإثبات بمصفوفة واحدة.

إذا رُفض إثبات عنوان لاحق لعنوان أُنشئ حديثًا، فلا تستبدل UUID الملف ولا تعِد إنشاء الهوية مرارًا. توقف وتحقق من الملف في البوابة أو عبر الدعم. ولا يزال مسار قراءة إثبات العنوان والبحث عنه قيدًا من قيود المراجعة.

استجابات النجاح والفشل بالتنسيق القديم

{
  "status": {
    "code": "success",
    "msg": "Successfully Saved."
  },
  "response": ""
}

رمز النجاح المعتاد لنقطة النهاية هذه هو السلسلة النصية success، بدلًا من العدد 200. وقد يستخدم الفشل المعتاد في النظام المنبع أو محليًا السلسلة النصية error. يشمل الرمز العددي 400 الحقول غير الصالحة أو إخفاقات الإثبات، ويشير 404 إلى ملف غير موجود أو مرجع غير صالح لملف مرفوع، ويشير 500 إلى نص طلب فارغ أو بلد تعذّر تحديده. اقرأ الرسالة وأي بنود للتحقق من صحة البيانات؛ ولا تعتبر HTTP 200 وحده دليلًا على النجاح.

القيود الحالية للتحديث والتعافي من الإخفاق

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

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