แสดงรายการโปรไฟล์การลงทะเบียน

ค้นหาโปรไฟล์การลงทะเบียนที่มีอยู่

แสดงรายการโปรไฟล์การลงทะเบียนภายในระบบที่ใช้งานอยู่และยังไม่ถูกลบ ซึ่งเชื่อมโยงกับบัญชี API ของคุณ ใช้รายการนี้เพื่อค้นหา UUID ของโปรไฟล์ก่อนเปิดโปรไฟล์ด้วย get_document ไม่ใช่เพื่อตรวจสอบว่าหลักฐานของโปรไฟล์หรือการลงทะเบียนหมายเลขได้รับอนุมัติแล้วหรือไม่

คำขอแสดงรายการ

ยืนยันตัวตนด้วยบัญชี MultiTEL API ที่เปิดใช้งานแล้วของคุณ และใช้ที่อยู่ IP ที่ได้รับอนุญาตสำหรับบัญชีนั้น ตัวอย่างใช้ข้อมูลรับรอง HTTP Basic ที่จัดเก็บไว้ในตัวแปรสภาพแวดล้อม ตรวจสอบทั้งการตอบกลับ HTTP และค่าใน JSON status.code; การตอบกลับ HTTP 200 เพียงอย่างเดียวไม่ยืนยันว่าคำขอสำเร็จ ค่าทั้งหมดในตัวอย่างเป็นข้อมูลสมมติ

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

ตัวจัดการนี้ไม่ได้รองรับเนื้อหาคำขอ การแบ่งหน้า หรือพารามิเตอร์ตัวกรอง โดยจะส่งคืนโปรไฟล์ที่จัดเก็บไว้ของบัญชีที่ตรงกัน อย่าสันนิษฐานว่ารายการจะเรียงลำดับแบบใดแบบหนึ่ง สำหรับบัญชีขนาดใหญ่ ควรหลีกเลี่ยงการเรียกดึงรายการทั้งหมดซ้ำบ่อย ๆ

รายการในการตอบกลับ

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "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"
    }
  ]
}

หากไม่มีโปรไฟล์ที่ใช้งานอยู่ซึ่งตรงกัน ตัวจัดการจะส่งคืนรหัส API 200 และรายการว่างในการตอบกลับ response[].id คือ UUID ของโปรไฟล์ภายในระบบที่ส่งคืนในชื่อ uuid ขณะสร้าง ไม่ใช่ ID ของข้อมูลประจำตัวหรือ ID ของที่อยู่

ฟิลด์โปรไฟล์ที่ส่งคืน

ชุดฟิลด์ที่เลือกส่งคืนประกอบด้วย 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 ข้อมูลอ้างอิงไฟล์ที่อัปโหลด รายการหลักฐาน และสถานะการตรวจสอบยืนยัน นี่ไม่ใช่เอนด์พอยต์สำหรับตรวจสอบสถานะหลักฐานหรือการอนุมัติการลงทะเบียน ให้ถือว่าข้อมูลประจำตัว ข้อมูลติดต่อ และข้อมูลลายเซ็นที่ส่งคืนเป็นข้อมูลส่วนตัว

ขั้นตอนถัดไป

บันทึก ID ของเอนทิตีจากการตอบกลับเดิมของ create_document ไว้สำหรับการแนบข้อมูลในภายหลัง หากการตอบกลับนั้นสูญหาย รายการนี้จะไม่สามารถกู้คืน ID เหล่านั้นได้ ตรวจสอบโปรไฟล์ใน พอร์ทัล หรือติดต่อฝ่ายสนับสนุน แทนการสร้างโปรไฟล์ซ้ำโดยอัตโนมัติ