บัตรประชาชนไทยแบบถ่ายสำเนา พร้อมตรวจจับลายเซ็น

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

POST/v3/store/ekyc/thai-national-id-card-with-signatureทดลองใช้

• ราคา1.25 ICต่อหน้า
• ความแม่นยำ97.1%
• รองรับ10,500 ใบ/ชั่วโมง
• ให้บริการแล้ว49.6Kครั้ง

• v1.1.1-20260822
• อัปเดต 22 ส.ค. 2569
• ใช้งานได้
• รายงานผลทดสอบ (PDF)

Input

OutputPOST /v3/store/ekyc/thai-national-id-card-with-signature

national_id

3411700830334

fullname_th

นาง บุญยัง โลเปช

fullname_en

Mrs. Bunyang Lopez

date_of_birth

22 มี.ค. 2500

address_full

33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี

reason_code_id_card_signature

1

process_time

0.7

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Response

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@idcard.jpg"

Response

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

{
    "national_id": "3411700830334",
    "fullname_th": "นาง บุญยัง โลเปช",
    "fullname_en": "Mrs. Bunyang Lopez",
    "date_of_birth": "22 มี.ค. 2500",
    "address_full": "33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "reason_code_id_card_signature": 1,
    "process_time": 0.7
}

Request

ส่งเป็น multipart/form-data ครั้งละหนึ่งใบ ถ้าเป็นภาพถ่ายบัตรจริง ใช้ OCR บัตรประชาชนไทย

Headers

apikeystringrequired

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

Body

filefilerequired

ด้านหน้าของบัตรตามที่ถ่ายหรือสำเนา ไฟล์ JPEG, PNG, HEIC หรือ HEIF ไม่เกิน 2 MB บัตรในภาพต้องมีขนาดอย่างน้อย 600 × 400 พิกเซล

path เดิม /thai-national-id-card-with-signature/front และ /thai-national-id-card/copy ยังใช้ได้ในราคาเดียวกัน

Response

national_idstring

เลข 13 หลัก

init_thinit_enname_thname_ensurname_thsurname_enfullname_thfullname_en

คำนำหน้า ชื่อ นามสกุล และชื่อเต็ม ทั้งไทยและอังกฤษ

date_of_birthdate_of_expire

รูปแบบไทยตามที่พิมพ์

address_fulladdress_numberaddress_subdistrictaddress_districtaddress_provinceaddress_postal_code

ที่อยู่ตามที่พิมพ์และส่วนย่อย รหัสไปรษณีย์อนุมานให้

reason_code_id_cardreason_code_id_card_national_idreason_code_id_card_signature

เป็น 1 เมื่อพบบัตร พบเลขบัตร และพบลายเซ็น ไม่พบเป็น 0

confidence

ค่า 0 ถึง 1 รายฟิลด์: national_id, fullname_th, date_of_birth, address_full

process_timerequest_idfile_name_id_cardreason_code_api

วินาที request ID จากเกตเวย์ ชื่อไฟล์ และรหัสสถานะ

รหัสสถานะ

รหัส	ความหมาย
200	สำเร็จ
413	ไฟล์เกิน 2 MB
414	ไม่มีไฟล์แนบ
415, 422	ขนาดภาพอยู่นอกเกณฑ์
420	ไม่พบบัตรประชาชนในภาพ
421	รูปแบบภาพไม่รองรับหรือไฟล์เสีย
427, 428	ประมวลผลหรือรอคิวนานเกินกำหนด
560	เซิร์ฟเวอร์ไม่ว่าง ลองใหม่
563	ประมวลผลภาพนี้ไม่ได้

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

ผลการทดสอบ

เทียบกับข้อมูลที่คนตรวจแล้ว บัตรจริง 33 ใบ 594 ฟิลด์ ชุดข้อมูลไม่เปิดเผย

รายการ	ผล
เลขบัตรประชาชน	100%
บ้านเลขที่	97.0%
ที่อยู่เต็ม	93.9%
ทุกฟิลด์	97.1%
ตรวจจับลายเซ็น	96.5%
เวลากลาง	0.7 วินาทีต่อใบ
อัตราต่อเนื่อง	10,500 ใบต่อชั่วโมง บนระบบจริง สิงหาคม 2569

วิธีวัด ผลรายฟิลด์ และการเทียบกับ cloud OCR ชั้นนำ: รายงานผลการทดสอบ (PDF)

ข้อจำกัด

• สแกนที่ 300 dpi ขึ้นไปให้ผลดีที่สุด
• บัตรที่เบลอ หรือเล็กมากในภาพ อ่านได้แย่ลง

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

รูปภาพประมวลผลในหน่วยความจำและไม่เก็บไว้หลังส่ง Response บริการเป็นไปตาม GDPR และ PDPA ถ้าต้องการติดตั้งบนเซิร์ฟเวอร์ของคุณเองโดยข้อมูลบัตรไม่ออกจากเครือข่าย ติดต่อเรา

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
v1.1.1-20260822	22 ส.ค. 2569	เอนจินใหม่ ความถูกต้องรายฟิลด์จาก 96.3% เป็น 97.1% ดีขึ้นมากที่สุดที่บ้านเลขที่และที่อยู่ ติดตั้งบนเซิร์ฟเวอร์ของคุณได้
v1.0	2566	เปิดให้บริการ พร้อมตรวจจับลายเซ็น