OCR หนังสือเดินทาง

อ่านแถบ MRZ ของหนังสือเดินทางตามมาตรฐาน ICAO 9303 ทุกประเทศ ส่งกลับข้อมูลผู้ถือ รูปถ่าย และบอกว่าแต่ละฟิลด์ตรงกับเลขตรวจสอบหรือไม่

POST/v3/store/ekyc/passportทดลองใช้

• ราคา0.75 ICต่อหน้า
• ความแม่นยำ95.5%
• รองรับ15,000 เล่ม/ชั่วโมง
• ให้บริการแล้ว317.1Kครั้ง

• v2.0.5-20260825
• อัปเดต 25 ส.ค. 2569
• ใช้งานได้
• รายงานผลทดสอบ (PDF)

Input

OutputPOST /v3/store/ekyc/passport

number

AA1234567

valid_number

true

surname

SPECIMEN

names

SOMCHAI

date_of_birth

01/01/90

valid_date_of_birth

true

expiration_date

31/12/30

valid_expiration_date

true

nationality

THA

valid_composite

true

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

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/passport \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@passport.jpg"

Response

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

{
    "number": "AA1234567",
    "valid_number": true,
    "surname": "SPECIMEN",
    "names": "SOMCHAI",
    "date_of_birth": "01/01/90",
    "valid_date_of_birth": true,
    "expiration_date": "31/12/30",
    "valid_expiration_date": true,
    "nationality": "THA",
    "valid_composite": true
}

Request

ส่งเป็น multipart/form-data ครั้งละหนึ่งเล่ม ไฟล์ PDF ให้ผลหน้าละหนึ่งรายการ

Headers

apikeystringrequired

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

Body

filefilerequired

หน้าข้อมูลของหนังสือเดินทาง ไฟล์ JPEG, PNG, WEBP หรือ PDF

fieldsstring

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

optionsstring

คั่นด้วยจุลภาค segmentation แก้ภาพที่วางผิดทิศ ใช้เวลาราวสองเท่า no_thresh ข้ามการเตรียมภาพส่วน MRZ

path เดิม /passport-ocr, /passport-ocr/v2 และ /passport-ocr/v2/ocr ไปที่บริการเดียวกันในราคาเดียวกัน

Response

เป็นออบเจ็กต์ชั้นเดียว ให้ดู valid_number ถ้าเป็น false เลขนั้นเป็นของหนังสือเดินทางจริงไม่ได้ ให้ถ่ายหน้านั้นใหม่

numberstring

เลขหนังสือเดินทาง

surnamenames

ตามที่พิมพ์ใน MRZ

date_of_birthexpiration_date

รูปแบบ DD/MM/YY เพราะ MRZ ไม่ระบุศตวรรษ

sex

M, F หรือ < เมื่อไม่ระบุ

nationalitycountry

รหัส ISO 3166-1 alpha-3 โดย country คือประเทศผู้ออก

personal_number

ว่างในหนังสือเดินทางหลายประเทศ

typemrz_type

P< สำหรับหนังสือเดินทางทั่วไป TD3 สำหรับ MRZ แบบหนังสือเดินทาง

face

รูปถ่ายใบหน้า เป็น Base64 JPEG

valid_numbervalid_date_of_birthvalid_expiration_datevalid_personal_numbervalid_composite

แต่ละค่าตรงกับเลขตรวจสอบหรือไม่ valid_composite คือทั้ง MRZ

valid_score

สัดส่วนเลขตรวจสอบที่ผ่าน 0 ถึง 100

ฟิลด์วินิจฉัยและรหัสสถานะ

ฟิลด์	ความหมาย
check_number, check_date_of_birth, check_expiration_date, check_personal_number, check_composite	เลขตรวจสอบตามที่พิมพ์
raw_text	MRZ สองบรรทัด บรรทัดละ 44 ตัวอักษร
method	วิธีที่ใช้หาแถบ MRZ
inference	วินาที
file_name, message, status_code	Success และ 200 เมื่อสำเร็จ

ถ้าหา MRZ ไม่พบ Response ยังเป็น 200 พร้อมฟิลด์ Error Message ส่วนใหญ่ options=segmentation แก้ภาพที่วางผิดทิศได้ รหัสของบริการเอง: 415 ชนิดไฟล์ไม่รองรับ 461 ไม่มีไฟล์แนบ 462 ฟอร์มไม่มีคีย์ file

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

ผลการทดสอบ

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

รายการ	ผล
อ่าน MRZ ได้	100%
เลขหนังสือเดินทางผ่านการตรวจ	96.2%
วันเกิดผ่านการตรวจ	99.2%
วันหมดอายุผ่านการตรวจ	98.1%
เลข วันเกิด และวันหมดอายุผ่านทั้งหมด	95.5%
เวลากลาง	0.4 วินาทีต่อเล่ม
อัตราต่อเนื่อง	15,000 เล่มต่อชั่วโมง บนระบบจริง สิงหาคม 2569

เลขตรวจสอบมีหลักเดียว การอ่านผิดราวหนึ่งในสิบจึงผ่านโดยบังเอิญ ความแม่นยำจริงต่ำกว่าตัวเลขนี้เล็กน้อย วิธีวัด: รายงานผลการทดสอบ (PDF)

ข้อจำกัด

• อ่านเฉพาะแถบ MRZ ไม่อ่านข้อความส่วนอื่นของหน้า

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

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

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
v2.0.5-20260825	25 ส.ค. 2569	วันที่ส่งกลับเป็น DD/MM/YY ตามรูปแบบที่ใช้มาตั้งแต่ 2566 ผู้ที่แปลงรูปแบบชั่วคราว YYMMDD ต้องปรับ และเพิ่ม type, mrz_type, method และ valid_score
v2.0.3-20260825	25 ส.ค. 2569	การรู้จำใหม่พร้อมการตรวจโครงสร้าง MRZ อัตราอ่านผ่านการตรวจครบเพิ่มจาก 58.6% เป็น 95.5% ส่ง valid_date_of_birth และ valid_expiration_date และติดตั้งบนเซิร์ฟเวอร์ของคุณได้
v2.0	ก.พ. 2566	อ่าน MRZ พร้อมรูปใบหน้าและธงเลขตรวจสอบ