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

0.75 ICต่อหน้า

v2.0.5-20260825 ใช้งานอยู่ ตั้งแต่ ก.พ. 2023 อัปเดตล่าสุด 25 ส.ค. 2026 15,000 เล่ม/ชั่วโมง อ่านผ่านการตรวจสอบ 95.5% Whitepaper (PDF) POST /v3/store/ekyc/passport

มี Mobile & Web SDK ให้บริการ

ข้ามขั้นตอนการจัดการกล้อง — eKYC SDK แบบโอเพนซอร์สฟรีของเรา (Web, Flutter, iOS, Android และ React Native) จะจับภาพเอกสารและใบหน้าโดยอัตโนมัติและเรียก API นี้ให้คุณ ดูบน GitHub

Passport OCR API อ่านข้อมูล machine-readable zone (MRZ) ของหนังสือเดินทางตามมาตรฐาน ICAO 9303 ทุกเล่ม และส่งคืนข้อมูลของผู้ถือ — หมายเลขหนังสือเดินทาง ชื่อ วันที่ สัญชาติ — พร้อมรูปถ่ายใบหน้าและชุดค่าสถานะการตรวจสอบความถูกต้อง MRZ ของหนังสือเดินทางสามารถตรวจสอบความถูกต้องได้ในตัวเอง: ทุกฟิลด์สำคัญมีเลขตรวจสอบ (check digit) ของตนเอง และค่าสถานะ valid_* จะรายงานว่าค่าที่ส่งคืนแต่ละค่าสอดคล้องกับเลขตรวจสอบนั้นหรือไม่ ผลการอ่านจึงเชื่อถือได้ด้วยการตรวจสอบทางคณิตศาสตร์ ไม่ใช่ด้วยการคาดเดา บริการ production ตอบกลับภายใน 0.4 วินาที (ค่ามัธยฐาน) และรองรับปริมาณงานต่อเนื่อง 9,500 เล่มต่อชั่วโมง จากชุดทดสอบหนังสือเดินทาง 266 เล่ม ผลการอ่าน 95.5% ส่งคืนหมายเลขหนังสือเดินทาง วันเกิด และวันหมดอายุที่ผ่านการตรวจสอบกับเลขตรวจสอบครบทั้งหมด และ MRZ แยกวิเคราะห์ได้สำเร็จ 100% ดูรายละเอียดที่ ความแม่นยำ

ทดลองเดโม

อัปโหลดรูปหน้าข้อมูลของหนังสือเดินทาง หรือใช้ภาพตัวอย่างด้านล่าง

ทดลองใช้ AI Demo

เข้าสู่ระบบหรือสร้างบัญชีฟรีเพื่อใช้งาน AI Demo และสำรวจ API ที่ทรงพลังของเรา

รับ 50 เครดิตฟรี (IC) เมื่อสมัครสมาชิก!

โปรโมชันหมดเขต 31 ธันวาคม 2568

สร้างบัญชีฟรีเข้าสู่ระบบ

Example Images (Click to try)

Try Demo

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

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

ลองใช้ SDK (กล้องสด)

ไม่ต้องการอัปโหลดไฟล์ใช่หรือไม่ iApp eKYC Web SDK แบบโอเพนซอร์สฟรี จะจับภาพหน้าข้อมูลหนังสือเดินทางโดยอัตโนมัติจากกล้องของคุณ — ระบบจะตรวจจับขอบเขตของหน้าเอกสาร รอเฟรมที่คมชัดและนิ่ง ปรับแก้มุมมองของรูปภาพ (perspective correction) และส่งไปยัง API นี้ ดูขั้นตอนเพิ่มเติมได้ที่ หน้าเดโมสด SDK ฉบับเต็ม

Loading live demo…

เริ่มต้นใช้งานอย่างรวดเร็ว

คุณต้องมีคีย์ API จากหน้า การจัดการคีย์ API จากนั้นส่งรูปภาพเป็น multipart/form-data:

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

{
    "number": "AC1062346",
    "valid_number": true,
    "surname": "POSHNASWADIWONG",
    "names": "MATHANIDA",
    "date_of_birth": "10/07/93",
    "valid_date_of_birth": true,
    "expiration_date": "04/03/25",
    "valid_expiration_date": true,
    "nationality": "THA",
    "valid_composite": true
}

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

Endpoint และราคา

Endpoint	ผลลัพธ์	ราคา
POST /v3/store/ekyc/passport	JSON พร้อมข้อมูลผู้ถือ ค่าสถานะการตรวจสอบเลขตรวจสอบ และรูปถ่ายใบหน้า	0.75 IC ต่อหน้า

เส้นทางรุ่นเก่า /passport-ocr, /passport-ocr/v2 และ /passport-ocr/v2/ocr ยังคงรองรับในราคาเดียวกันและเข้าถึงบริการเดียวกัน สำหรับการติดตั้งแบบ on-premise ดูที่ ความปลอดภัยของข้อมูล

ประสิทธิภาพ

วัดจากบริการ production เมื่อเดือนสิงหาคม 2026

ตัวชี้วัด	ค่า
เวลาประมวลผลมัธยฐาน	0.4 วินาทีต่อเล่ม
ปริมาณงานต่อเนื่อง	4.3 เล่มต่อวินาที (15,000 เล่มต่อชั่วโมง)
รูปแบบไฟล์นำเข้าที่รองรับ	JPEG, JPG, PNG, WEBP, PDF (หนึ่งผลลัพธ์ต่อหน้า)
ความครอบคลุม	หนังสือเดินทางแบบอ่านด้วยเครื่องตามมาตรฐาน ICAO 9303 ทุกเล่ม

ความแม่นยำ

MRZ ของหนังสือเดินทางมีเลขตรวจสอบอยู่ในตัวเอง ความถูกต้องจึงวัดได้ด้วยการคำนวณบนชุดทดสอบหนังสือเดินทาง 266 เล่ม — ไม่ต้องอาศัยการถอดความอ้างอิงและไม่มีการใช้ดุลยพินิจ: ฟิลด์ที่ส่งคืนจะสอดคล้องกับเลขตรวจสอบที่พิมพ์บนหนังสือเดินทางหรือไม่สอดคล้อง เท่านั้น

การวัด	v2.0.3
แยกวิเคราะห์ MRZ ได้	100%
หมายเลขเอกสารผ่านการตรวจสอบ	96.2%
วันเกิดผ่านการตรวจสอบ	99.2%
วันหมดอายุผ่านการตรวจสอบ	98.1%
หมายเลขประจำตัวผ่านการตรวจสอบ	98.5%
หมายเลข วันเกิด และวันหมดอายุผ่านการตรวจสอบครบทั้งหมด	95.5%

รุ่นเดือนสิงหาคม 2026 ยกระดับอัตราการอ่านที่ผ่านการตรวจสอบครบทุกฟิลด์จาก 58.6% เป็น 95.5% — หมายเลขเอกสารที่ส่งคืนแต่ไม่ผ่านเลขตรวจสอบของตนย่อมไม่ใช่หมายเลขจริง และผลการอ่านลักษณะนี้ลดลงจาก 30% ของหนังสือเดินทางเหลือต่ำกว่า 4% ตัวชี้วัดนี้ตั้งใจให้เป็นการวัดแบบระมัดระวัง: เลขตรวจสอบเป็นเลขฐานสิบเพียงหนึ่งหลัก ผลการอ่านที่ผิดประมาณหนึ่งในสิบครั้งจึงผ่านการตรวจสอบได้โดยบังเอิญ หมายความว่าความแม่นยำที่แท้จริงต่ำกว่าตัวเลขเหล่านี้เล็กน้อยในทุกรุ่นที่วัดด้วยวิธีนี้ ระเบียบวิธีฉบับเต็ม ผลการวัดส่วนของเอนจินและส่วนของการตรวจสอบความถูกต้องที่วัดแยกจากกัน และคุณสมบัติด้านความปลอดภัยของตรรกะการแก้ไขข้อมูล (repair logic) เผยแพร่ไว้ใน whitepaper:

ดาวน์โหลด whitepaper ผลการทดสอบ (PDF)

ความปลอดภัยของข้อมูลและการปฏิบัติตามข้อกำหนด

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

เอกสารอ้างอิงทางเทคนิค

คำขอ (Request)

POST ด้วย multipart/form-data และส่วนหัว apikey

พารามิเตอร์	จำเป็น	คำอธิบาย
file	ใช่	รูปภาพหนังสือเดินทางหรือ PDF (JPG, JPEG, PNG, WEBP, PDF) ไฟล์ PDF จะส่งคืนหนึ่งรายการต่อหน้า แต่ละรายการประกอบด้วย page และ info
fields	ไม่	รายชื่อฟิลด์ที่ต้องการให้ส่งคืน คั่นด้วยเครื่องหมายจุลภาค หากไม่ระบุจะส่งคืนทุกฟิลด์
options	ไม่	คั่นด้วยเครื่องหมายจุลภาค segmentation ปรับแก้รูปภาพที่วางแนวผิดอย่างมาก (ช้าลงประมาณ 2 เท่า); no_thresh ข้ามการประมวลผลล่วงหน้าของภาพส่วนตัด MRZ

การตอบกลับ (Response)

200 พร้อม JSON object โครงสร้างชั้นเดียว (flat)

ข้อมูลผู้ถือ

ฟิลด์	คำอธิบาย
number	หมายเลขหนังสือเดินทาง
surname	นามสกุล ตามที่พิมพ์ใน MRZ
names	ชื่อตัว
date_of_birth	DD/MM/YY
expiration_date	DD/MM/YY
sex	M, F หรือ < หากไม่ระบุ
nationality	รหัสตาม ISO 3166-1 alpha-3
country	ประเทศผู้ออกเอกสาร รหัสตาม ISO 3166-1 alpha-3
personal_number	หมายเลขประจำตัว (ถ้ามี); เว้นว่างในหนังสือเดินทางจำนวนมาก
type	ประเภทเอกสารตามที่พิมพ์ใน MRZ (P< สำหรับหนังสือเดินทางทั่วไป)
mrz_type	รูปแบบ MRZ (TD3 สำหรับหนังสือเดินทาง)
face	รูปถ่ายใบหน้า ในรูปแบบ Base64 JPEG

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

ฟิลด์	คำอธิบาย
valid_number	หมายเลขหนังสือเดินทางสอดคล้องกับเลขตรวจสอบของตน
valid_date_of_birth	วันเกิดสอดคล้องกับเลขตรวจสอบของตน
valid_expiration_date	วันหมดอายุสอดคล้องกับเลขตรวจสอบของตน
valid_personal_number	หมายเลขประจำตัวสอดคล้องกับเลขตรวจสอบของตน
valid_composite	MRZ ทั้งหมดสอดคล้องกับเลขตรวจสอบรวม (composite check digit)
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 ในภาพ คำขอจะยังคงส่งคืน 200 พร้อมฟิลด์ Error Message; การใช้ options=segmentation มักแก้ปัญหารูปภาพที่วางแนวผิดได้

รหัสการตอบกลับ

รหัสสถานะ	คำอธิบาย
200	สำเร็จ (รวมถึงกรณีไม่พบ MRZ ซึ่งรายงานในเนื้อหาการตอบกลับ)
415	ประเภทไฟล์ไม่รองรับ
461	ไม่ได้แนบไฟล์
462	ฟอร์มคำขอไม่มีคีย์ file

ตัวอย่างโค้ด

cURL

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

Python

import requests

url = "https://api.iapp.co.th/v3/store/ekyc/passport"
headers = {"apikey": "YOUR_API_KEY"}
files = {"file": open("passport.jpg", "rb")}

response = requests.post(url, headers=headers, files=files)
result = response.json()
if not result.get("valid_number"):
    print("Re-capture: the number failed its check digit")
print(result)

JavaScript

const axios = require("axios");
const FormData = require("form-data");
const fs = require("fs");

const data = new FormData();
data.append("file", fs.createReadStream("passport.jpg"));

axios.post("https://api.iapp.co.th/v3/store/ekyc/passport", data, {
    headers: { apikey: "YOUR_API_KEY", ...data.getHeaders() },
})
    .then((response) => console.log(response.data))
    .catch((error) => console.log(error));

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.iapp.co.th/v3/store/ekyc/passport',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => array(
        'file' => new CURLFILE('passport.jpg')
    ),
    CURLOPT_HTTPHEADER => array(
        'apikey: YOUR_API_KEY'
    ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/v3/store/ekyc/passport")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var body = Data()
body.append("--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"passport.jpg\"\r\n".data(using: .utf8)!)
body.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
if let fileData = try? Data(contentsOf: URL(fileURLWithPath: "passport.jpg")) {
    body.append(fileData)
}
body.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = body

URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8)!)
    }
}.resume()

Kotlin

import okhttp3.*
import okhttp3.MediaType.Companion.toMediaTypeOrNull
import okhttp3.RequestBody.Companion.asRequestBody
import java.io.File

val client = OkHttpClient()
val file = File("passport.jpg")

val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.name, file.asRequestBody("image/jpeg".toMediaTypeOrNull()))
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/passport")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(requestBody)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body?.string())
}

Java

import okhttp3.*;
import java.io.File;

OkHttpClient client = new OkHttpClient();
File file = new File("passport.jpg");

RequestBody requestBody = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.getName(),
        RequestBody.create(MediaType.parse("image/jpeg"), file))
    .build();

Request request = new Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/passport")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(requestBody)
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

Dart

import 'package:http/http.dart' as http;

var request = http.MultipartRequest(
    'POST',
    Uri.parse('https://api.iapp.co.th/v3/store/ekyc/passport'),
);
request.files.add(await http.MultipartFile.fromPath('file', 'passport.jpg'));
request.headers.addAll({'apikey': 'YOUR_API_KEY'});

var response = await request.send();
print(await response.stream.bytesToString());

ข้อจำกัด

• อ่านเฉพาะ machine-readable zone เท่านั้น ข้อความในส่วน visual zone นอก MRZ จะไม่ถูกดึงออกมา
• ปีแบบสองหลักใน date_of_birth และ expiration_date เป็นคุณสมบัติของมาตรฐาน MRZ ซึ่งไม่ได้เข้ารหัสศตวรรษไว้
• ภาพถ่ายที่วางแนวผิดหรือเอียงมากอาจต้องใช้ options=segmentation ซึ่งใช้เวลาประมวลผลประมาณสองเท่า

ประวัติการเปลี่ยนแปลง

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
v2.0.5-20260825	25 ส.ค. 2026	endpoint สาธารณะให้บริการด้วยบริการหนังสือเดินทางแบบรวมศูนย์แล้ว วันที่ส่งคืนในรูปแบบ DD/MM/YY ซึ่งเป็นรูปแบบที่บริการนี้ส่งคืนให้ผู้ใช้งานมาตั้งแต่ปี 2023 ผู้เรียกที่เคยแยกวิเคราะห์รูปแบบ YYMMDD ชั่วคราวต้องปรับปรุงโค้ด เพิ่มฟิลด์ type, mrz_type, method และ valid_score (เปอร์เซ็นต์ของเลขตรวจสอบที่ผ่านการตรวจ) ปริมาณงานต่อเนื่องเพิ่มเป็น 15,000 เล่มต่อชั่วโมง
v2.0.3-20260825	25 ส.ค. 2026	อัปเกรดระบบรู้จำและเพิ่มการตรวจสอบความถูกต้องเชิงโครงสร้างของ MRZ อัตราการอ่านที่ผ่านการตรวจสอบเลขตรวจสอบครบทุกฟิลด์ (หมายเลข วันเกิด และวันหมดอายุพร้อมกัน) เพิ่มขึ้นจาก 58.6% เป็น 95.5% บนชุดทดสอบหนังสือเดินทาง 266 เล่ม และ MRZ ทุกรายการแยกวิเคราะห์ได้สำเร็จ เวลาประมวลผลมัธยฐานลดลงจาก 0.26 วินาที เหลือ 0.4 วินาที ฟิลด์ valid_date_of_birth และ valid_expiration_date ที่ระบุไว้ในเอกสารถูกส่งคืนจริงแล้ว มีบริการติดตั้งแบบ on-premise ที่ทำงานได้ในตัวเองอย่างสมบูรณ์
v2.0	ก.พ. 2023	ดึงข้อมูล MRZ พร้อมรูปภาพใบหน้าและค่าสถานะเลขตรวจสอบ