เทียบใบหน้ากับบัตรประชาชนสำหรับ KYC

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

POST/v3/store/ekyc/face-and-id-card-verification

และอีก 2 endpoint

ทดลองใช้

• ราคา1 ICต่อครั้ง
• ให้บริการแล้ว65.4Kครั้ง

• v1.0
• ใช้งานได้

Input

OutputPOST /v3/store/ekyc/face-and-id-card-verification

idcard

confidence: 66.872 isSamePerson: true

selfie

confidence: 86.04 isSamePerson: true

time_process

0.824

total

confidence: 76.456 isSamePerson: true

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Responseendpoint อื่น: /back, /front ดูที่ Request

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification \
  -H "apikey: YOUR_API_KEY" \
  -F "file0=@id-card.jpg" \
  -F "file1=@selfie.jpg"

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
    "idcard": { "confidence": 66.872, "isSamePerson": "true" },
    "selfie": { "confidence": 86.04, "isSamePerson": "true" },
    "time_process": 0.824,
    "total": { "confidence": 76.456, "isSamePerson": "true" }
}

Request

ส่งเป็น multipart/form-data พร้อมบัตรและเซลฟี่ในครั้งเดียว

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

file0filerequired

บัตรประชาชน ถ่ายให้เห็นรูปบนบัตรชัด ไฟล์ JPEG, PNG หรือ GIF ขนาดอย่างน้อย 600 × 400 พิกเซล ไม่เกิน 10 MB

file1filerequired

เซลฟี่ของเจ้าของบัตร เกณฑ์เดียวกัน

Endpoint	ส่งกลับ	ราคา
/v3/store/ekyc/face-and-id-card-verification	ผลตัดสิน	1 IC ต่อครั้ง
/v3/store/ekyc/face-and-id-card-verification/front	ผลตัดสิน จากด้านหน้าบัตรประชาชนไทย	1 IC ต่อหน้า
/v3/store/ekyc/face-and-id-card-verification/back	แบบเดียวกัน จากด้านหลัง	1 IC ต่อหน้า

path เดิม /face-verify-id2, /thai-national-id-card/v3/front/kyc และ /thai-national-id-card/v3/back/kyc ยังใช้ได้ในราคาเดียวกัน

Response

idcardselfie

ผลการตรวจสองส่วน

idcard.confidencenumber

0 ถึง 100

idcard.isSamePersonstring

totalobject

ผลรวม โดย confidence เป็นค่าเฉลี่ยของสองส่วน

total.confidencenumber

0 ถึง 100

total.isSamePersonstring

time_processnumber

วินาที

รหัสสถานะ

รหัส	ความหมาย
413	ไฟล์ใดไฟล์หนึ่งเกิน 10 MB
415, 442	รูปแบบไฟล์ไม่รองรับ
420	ขาด file0 หรือ file1
421	ไม่พบใบหน้าหรือบัตรในภาพ
422	ไม่พบใบหน้าบนบัตรหรือในเซลฟี่
441	ส่งรูปมากเกินไป
461	ไม่มีไฟล์แนบ

รายละเอียดเพิ่มเติม

ผลการทดสอบ

รายการ	ผล
อัตราปฏิเสธผิด	ต่ำกว่า 3%
อัตรายอมรับผิด	ต่ำกว่า 0.1%

ข้อจำกัด

• เซลฟี่มีได้หนึ่งหน้า

การจัดการข้อมูล

รูปภาพประมวลผลในหน่วยความจำและไม่เก็บไว้หลังส่งผลกลับ บริการเป็นไปตาม GDPR และ PDPA