قراءة ملف تسجيل

قراءة ملف محفوظ واحد

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

طلب قراءة الملف

صادِق باستخدام حسابك المفعّل لواجهة MultiTEL API وعنوان IP المسموح به لهذا الحساب. تستخدم الأمثلة بيانات اعتماد للمصادقة الأساسية عبر HTTP مخزنة في متغيرات البيئة. تحقّق من استجابة HTTP ومن حقل JSON status.code؛ فاستجابة HTTP 200 وحدها لا تؤكد نجاح العملية. جميع القيم الواردة في الأمثلة افتراضية.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document/$DOCUMENT_UUID"

عيّن DOCUMENT_UUID إلى قيمة response.uuid المُرجعة من create_document، أو إلى قيمة response[].id المُرجعة من documents. لا تستخدم هنا identity_id أو address_id أو معرّف مستند إثباتي أو رقم هاتف. لا يلزم إرسال متن للطلب.

استجابة الملف

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "id": "11111111111111111111111111111111",
    "first_name": "Example",
    "last_name": "Person",
    "phone_number": "12025550123",
    "id_number": "",
    "birth_date": null,
    "company_name": "",
    "company_reg_number": "",
    "vat_id": "",
    "personal_tax_id": "",
    "description": "Example profile",
    "identity_type": "Personal",
    "postal_code": "00000",
    "city": "Example City",
    "address": "1 Example Street",
    "signature": "BASE64_PNG_SIGNATURE_DATA",
    "date_created": "2026-10-23 16:00:00"
  }
}

حقول الملف المُرجعة

تتضمن مجموعة الحقول المحددة id، first_name، last_name، phone_number، id_number، birth_date، company_name، company_reg_number، vat_id، personal_tax_id، description، identity_type، postal_code، city، address، signature و date_created.

قد تكون القيم الاختيارية فارغة أو null بحسب البيانات المخزنة. لا تتضمن مجموعة الحقول القديمة هذه email أو محددات البلدان أو identity_id أو address_id أو مراجع الملفات المرفوعة أو قوائم المستندات الإثباتية أو حالة التحقق. نقطة النهاية هذه ليست مخصصة للاستعلام عن حالة المستندات الإثباتية أو الموافقة على التسجيل. تعامل مع بيانات الهوية والاتصال والتوقيع المُرجعة على أنها بيانات خاصة.

عدم العثور على الملف وإعادة المحاولة

رمز API 404 المصحوب بالرسالة Failed, Not found يعني أنه لم يُعثر على ملف نشط مطابق لهذا الحساب وUUID. تحقّق من الحساب والمعرّف وما إذا كان الملف قد حُذف. لا يكشف هذا البحث عن ملف تابع لحساب آخر.

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