OCR บัตรประชาชนไทย

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

POST/v3/store/ekyc/thai-national-id-card/front

และอีก 1 endpoint

ทดลองใช้

• ราคา1.25 ICต่อหน้า
• ความแม่นยำ98.0%
• รองรับ5,000 ใบ/ชั่วโมง
• ให้บริการแล้ว24.1Mครั้ง

• v3.6.0-20260824
• อัปเดต 24 ส.ค. 2569
• ใช้งานได้
• รายงานผลทดสอบ (PDF)

Input

OutputPOST /v3/store/ekyc/thai-national-id-card/front

id_number

3411700830334

th_name

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

en_name

Mrs. Bunyang Lopez

en_dob

22 Mar. 1957

address

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

province

ชลบุรี

detection_score

0.979

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

Request

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

Response

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

{
    "id_number": "3411700830334",
    "th_name": "นาง บุญยัง โลเปช",
    "en_name": "Mrs. Bunyang Lopez",
    "en_dob": "22 Mar. 1957",
    "address": "33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "province": "ชลบุรี",
    "detection_score": 0.979
}

Request

ส่งเป็น multipart/form-data ครั้งละหนึ่งด้านของหนึ่งใบ ถ้าเป็นสำเนาที่ถ่ายรูป ใช้ บัตรประชาชนไทยแบบถ่ายสำเนา พร้อมตรวจจับลายเซ็น

Headers

apikeystringrequired

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

Body

filefilerequired

ภาพบัตร ไฟล์ JPEG, PNG, HEIC, HEIF หรือ PDF ไม่เกิน 10 MB บัตรในภาพต้องมีขนาดอย่างน้อย 600 × 400 พิกเซล แนะนำ 1,000 × 630 ขึ้นไป

fieldsstring

ชื่อฟิลด์ที่ต้องการ คั่นด้วยจุลภาค ถ้าไม่ระบุจะส่งกลับทุกฟิลด์ เฉพาะด้านหน้า

optionsstring

คั่นด้วยจุลภาค get_bbox เพิ่มกรอบของแต่ละฟิลด์เป็น [x1, y1, x2, y2] พร้อมคะแนน get_image เพิ่มภาพตัดของแต่ละฟิลด์เป็น Base64 get_original เพิ่มค่าก่อนการแก้อัตโนมัติ not_crop_card และ not_rotate_card ข้ามการตัดและหมุนภาพ id_check ปฏิเสธเลขบัตรที่ไม่ผ่านเลขตรวจสอบ gray_check ปฏิเสธภาพขาวดำ

Endpoint	ส่งกลับ	ราคา
/v3/store/ekyc/thai-national-id-card/front	ทุกฟิลด์ด้านหน้า	1.25 IC ต่อหน้า
/v3/store/ekyc/thai-national-id-card/back	รหัสเลเซอร์	0.75 IC ต่อหน้า

path เดิม /thai-national-id-card/v3.5/front และ /thai-national-id-card/v3.5.1/back ยังใช้ได้ในราคาเดียวกัน

Response

ด้านหน้า ตามตัวอย่างในแผงด้านข้าง:

id_numberid_number_status

เลข 13 หลัก และพบเลขหรือไม่

th_initth_fnameth_lnameth_nameen_initen_fnameen_lnameen_name

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

th_dobth_issueth_expireen_doben_issueen_expire

วันเกิด วันออกบัตร และวันหมดอายุ ตามที่พิมพ์ในแต่ละภาษา

addresshouse_novillage_novillagealleylaneroadsub_districtdistrictprovincepostal_code

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

genderreligion

ตามที่พิมพ์ religion ว่างเมื่อบัตรไม่ระบุ

face

รูปถ่าย เป็น Base64 JPEG

confidence

ค่า 0 ถึง 1 รายฟิลด์

detection_scoreerror_messageprocess_timerequest_id

คะแนนการตรวจพบบัตร ข้อผิดพลาดถ้ามี วินาที

ด้านหลังส่งกลับ back_number รหัสเลเซอร์ 12 ตัวอักษร พร้อม detection_score และ process_time

รหัสสถานะ

รหัส	ความหมาย
420, 430	ไม่พบบัตรประชาชนในภาพ (หน้า, หลัง)
421, 431	รูปแบบภาพไม่รองรับหรือไฟล์เสีย
422, 432	ขนาดภาพอยู่นอกเกณฑ์
424	เลขบัตรครบ 13 หลักแต่ไม่ผ่านเลขตรวจสอบ เมื่อใช้ id_check
425	เลขบัตรไม่ครบ 13 หลัก เมื่อใช้ id_check
426, 436	ภาพขาวดำ เมื่อใช้ gray_check
434	ไม่พบรหัสเลเซอร์ด้านหลัง
435	รหัสเลเซอร์ไม่ครบ 12 ตัว เมื่อใช้ id_check
413	ไฟล์ใหญ่เกินไป
427, 428	ประมวลผลหรือรอคิวนานเกินกำหนด
461	ไม่มีไฟล์แนบ
560	เซิร์ฟเวอร์ไม่ว่าง ลองใหม่
563	ประมวลผลภาพนี้ไม่ได้

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

ผลการทดสอบ

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

รายการ	ผล
เลขบัตรประชาชน	100%
นามสกุลอังกฤษ คำนำหน้า เพศ ศาสนา	100%
ตำบล อำเภอ รหัสไปรษณีย์ จังหวัด วันที่	100%
ที่อยู่เต็ม	98.3%
ชื่อเต็มภาษาไทย	93.3%
ทุกฟิลด์	98.0%
เวลากลาง	1.4 วินาทีต่อใบ ด้านหน้า 1.3 วินาที ด้านหลัง
อัตราต่อเนื่อง	5,000 ใบต่อชั่วโมง บนระบบจริง สิงหาคม 2569

ชื่อเต็มภาษาไทยลดลงจาก 96.7% เป็น 93.3% ในเอนจินรุ่นสิงหาคม 2569 ถ้าระบบของคุณจับคู่ด้วยชื่อไทยแทนเลขบัตรหรือที่อยู่ ให้ดูค่าความมั่นใจของฟิลด์นั้น วิธีวัด ผลรายฟิลด์ และการเทียบกับ cloud OCR ชั้นนำ: รายงานผลการทดสอบ (PDF)

ข้อจำกัด

• ถ่ายที่ 300 dpi ขึ้นไป แนะนำ 600 dpi และไฟล์ต่ำกว่า 5 MB
• ตรวจ detection_score และตรวจรูปแบบเลขบัตรในระบบของคุณเอง

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

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

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
v3.6.0-20260824	24 ส.ค. 2569	วันที่ภาษาอังกฤษ (en_dob, en_issue, en_expire) ตรงกับที่พิมพ์บนบัตรแล้ว เดือนแบบย่อมีจุด (23 Apr. 1997) ส่วน May ที่พิมพ์เต็มไม่มีจุด ให้การแปลงวันที่ฝั่งคุณรับรูปแบบที่มีจุด
v3.5.3-20260824	24 ส.ค. 2569	เอนจินใหม่ ความถูกต้องรายฟิลด์จาก 97.8% เป็น 98.0% ดีขึ้นมากที่สุดที่ที่อยู่ จังหวัด และวันหมดอายุ ติดตั้งบนเซิร์ฟเวอร์ของคุณได้
3.5	พ.ย. 2565	เอนจิน OCR ใหม่ เร็วขึ้น ตัวอักษรถูกต้อง 98.13%
3.4	ก.ค. 2565	เพิ่มยศทหารไทย 93.25%
3.0	ก.พ. 2564	ความแม่นยำ 91.75%
2.0	ก.พ. 2563	รองรับด้านหลัง 85%
1.0	พ.ย. 2562	เปิดให้บริการ 76%