นักพัฒนา

POST/v3/create_proof

แนบหลักฐานยืนยันตัวตนหรือที่อยู่

เชื่อมโยงไฟล์หลักฐานที่อัปโหลดแล้วกับข้อมูลตัวตนหรือที่อยู่ที่ถูกต้อง

ในหน้านี้
  1. แนบหลักฐานยืนยันตัวตนหรือที่อยู่
  2. สร้างรายการหลักฐาน
  3. เก็บรหัสหลักฐานไว้
  4. ข้อผิดพลาดและไฟล์อัปโหลดที่หมดอายุ

แนบหลักฐานยืนยันตัวตนหรือที่อยู่

ดำเนินการขั้นตอนนี้หลังจากสร้างข้อมูลตัวตนหรือที่อยู่แล้ว และอัปโหลดไฟล์ที่จำเป็นของข้อมูลนั้นผ่าน 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"
  }
}

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

ข้อผิดพลาดและไฟล์อัปโหลดที่หมดอายุ

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

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