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