อัปโหลดไฟล์หลักฐานสำหรับการลงทะเบียน

อัปโหลดก่อนแนบเอกสาร

อัปโหลดไฟล์สำหรับหลักฐานหรือเอกสารประกอบหนึ่งประเภท แล้วนำ ID ไฟล์ที่ได้รับกลับมาไปใช้แนบเอกสารผ่าน create_proof หรือ create_supporting_document การอัปโหลดเพียงอย่างเดียวไม่ได้สร้างรายการตัวตน ที่อยู่ หลักฐาน หรือทำให้การลงทะเบียนหมายเลขเสร็จสมบูรณ์ ให้เริ่มจาก ข้อกำหนดปัจจุบันและ ID จากแค็ตตาล็อก

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

การหมดอายุของรหัสอ้างอิงการอัปโหลดไม่ได้เป็นคำรับรองว่าสำเนาเอกสารที่จัดเก็บไว้ทั้งหมดจะถูกลบในเวลานั้น บริการเข้ารหัสไฟล์เพื่ออัปโหลดให้ผู้ให้บริการโทรคมนาคม และเก็บไบต์ต้นฉบับไว้สำหรับขั้นตอนการจัดการเอกสาร อย่าถือว่านี่เป็นการเข้ารหัสเฉพาะฝั่งไคลเอนต์หรือเป็นบริการที่ไม่เก็บรักษาข้อมูล อย่าใส่ ID ชื่อไฟล์ และการตอบกลับไว้ในบันทึกที่เปิดเผยต่อสาธารณะ

ข้อผิดพลาดและการลองใหม่

ตัวประมวลผลปัจจุบันใช้รหัส API 404 เมื่อไม่ได้ส่งไฟล์เอกสาร และใช้รหัส 500 สำหรับข้อผิดพลาดในการตรวจสอบคำอธิบาย พารามิเตอร์สำหรับเลือกที่ขาดหายหรือขัดแย้งกัน ID ประเภทหลักฐาน/แม่แบบที่ไม่ถูกต้อง การเกินขีดจำกัดจำนวนไฟล์หรือขนาดรวม ปัญหาการจัดเก็บ หรือการอัปโหลดที่ไม่สำเร็จ ให้อ่าน status.msg; ข้อมูลนำเข้าที่ไม่ถูกต้องไม่ได้แสดงด้วยรหัส 400 เสมอไป

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