🛂 การรู้จำหนังสือเดินทาง (OCR)

0.75 ICต่อหน้า

v2.0 Active ก.พ. 2023 POST /v3/store/ekyc/passport

ยินดีต้อนรับสู่ API การรู้จำหนังสือเดินทาง (Passport OCR) ของ iApp ซึ่งเป็นผลิตภัณฑ์ AI ที่พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด API ของเราได้รับการออกแบบมาเพื่อจดจำและดึงข้อมูลจากภาพถ่ายหนังสือเดินทางที่สแกนโดยอัตโนมัติด้วยความแม่นยำและความเร็วสูง ระบบนี้เน้นการอ่าน Machine Readable Zone (MRZ) ที่ด้านล่างของหน้าหนังสือเดินทาง โดยจะดึงข้อมูลสำคัญ เช่น ชื่อผู้ถือสัญชาติวันเกิด และอื่นๆ

ลองใช้เดโม!

ทดลองใช้ AI Demo

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

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

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

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

Example Images (Click to try)

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

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

เริ่มต้นใช้งาน

1. ข้อกำหนดเบื้องต้น

   • คีย์ API จาก ไอแอพพ์เทคโนโลยี
   • รูปถ่ายหนังสือเดินทางที่สแกน (หน้าข้อมูลส่วนตัว)
   • รูปแบบไฟล์ที่รองรับ: JPEG, JPG, PNG, PDF
   • ขนาดไฟล์สูงสุด: 10MB

2. เริ่มต้นอย่างรวดเร็ว

   • ประมวลผลรวดเร็ว (1-2 วินาทีต่อภาพ)
   • การดึงข้อความด้วยความแม่นยำสูง (95.51%)
   • รองรับรูปแบบไฟล์หลายรูปแบบ

3. คุณสมบัติหลัก

   • ดึงข้อมูลจาก TD3 type MRZ
   • การให้คะแนนและความถูกต้องของการรู้จำตัวอักษร (OCR)
   • การดึงรูปภาพใบหน้าในรูปแบบ base64
   • รองรับเอกสาร PDF หลายหน้า
   • จัดการกับภาพที่หมุนและเอียง
   • การประมวลผลเบื้องต้นด้วยการแบ่งส่วนภาพสำหรับภาพที่เอียง
   • รองรับภาษาไทยและภาษาอังกฤษ

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

   • เป็นไปตาม GDPR และ PDPA
   • ไม่มีการเก็บข้อมูลหลังจากการประมวลผล

จะขอรับ API Key ได้อย่างไร?

กรุณาไปที่หน้า การจัดการ API Key เพื่อดู API Key ที่มีอยู่ หรือขอรับคีย์ใหม่

ตัวอย่าง

หน้าข้อมูลส่วนตัว

คำขอ:

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

การตอบสนอง:

{
    "check_composite": "4",
    "check_date_of_birth": "4",
    "check_expiration_date": "4",
    "check_number": "6",
    "check_personal_number": "3",
    "country": "THA",
    "date_of_birth": "930710",
    "expiration_date": "250304",
    "method": "direct",
    "mrz_type": "TD3",
    "names": "MATHANIDA",
    "nationality": "THA",
    "number": "AC1062346",
    "personal_number": "0012345678913",
    "raw_text": "P<THAPOSHNASWADIWONG<<MATHANIDA<<<<<<<<<<<<<\nAC10623466THA9307104F25030440012345678913<34",
    "sex": "F",
    "surname": "POSHNASWADIWONG",
    "type": "P",
    "valid_composite": true,
    "valid_date_of_birth": true,
    "valid_expiration_date": true,
    "valid_number": true,
    "valid_personal_number": true,
    "valid_score": 100,
    "face": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
}

คำอธิบายฟิลด์การตอบสนอง

ฟิลด์	คำอธิบาย	รูปแบบ	ตัวอย่าง
check_composite	เลขตรวจสอบรวมสำหรับแถวบนและกลางของเครื่องอ่านข้อมูล	ตัวเลขเดี่ยว	"4"
check_date_of_birth	เลขตรวจสอบสำหรับฟิลด์วันเกิด	ตัวเลขเดี่ยว	"4"
check_expiration_date	เลขตรวจสอบสำหรับวันหมดอายุ	ตัวเลขเดี่ยว	"4"
check_number	เลขตรวจสอบสำหรับหมายเลขเอกสาร	ตัวเลขเดี่ยว	"6"
check_personal_number	เลขตรวจสอบสำหรับหมายเลขประจำตัว	ตัวเลขเดี่ยว	"3"
country	รหัสประเทศที่ออกหนังสือเดินทาง	3 ตัวอักษร	"THA"
date_of_birth	วันเกิด	YYMMDD	"930710"
expiration_date	วันหมดอายุเอกสาร	YYMMDD	"250304"
method	วิธีการอ่านที่ใช้	String	"direct"
mrz_type	ประเภทของโซนที่อ่านด้วยเครื่อง (machine readable zone)	String	"TD3"
names	ชื่อต้น/ชื่อกลาง	String	"MATHANIDA"
nationality	สัญชาติของเจ้าของ	3 ตัวอักษร	"THA"
number	หมายเลขหนังสือเดินทาง	String	"AC1062346"
personal_number	หมายเลขบัตรประจำตัวประชาชน	String	"0012345678913"
raw_text	ข้อความ MRZ ดิบจากหนังสือเดินทาง	String	"P<THAPOSHNASWADIWONG..."
sex	เพศ	ตัวอักษรเดี่ยว	"F"
surname	นามสกุล	String	"POSHNASWADIWONG"
type	ประเภทเอกสาร	String	"P"
valid_composite	การตรวจสอบเลขตรวจสอบรวมของ MRZ	Boolean	true
valid_date_of_birth	ความถูกต้องของเลขตรวจสอบวันเกิด	Boolean	true
valid_expiration_date	ความถูกต้องของเลขตรวจสอบวันหมดอายุ	Boolean	true
valid_number	ความถูกต้องของเลขตรวจสอบหมายเลขเอกสาร	Boolean	true
valid_personal_number	ความถูกต้องของเลขตรวจสอบหมายเลขประจำตัว	Boolean	true
valid_score	คะแนนความถูกต้องรวม	Integer 0-100	100
face	รูปภาพใบหน้า	Base64 string	"/9j/4AAQSkZJRgABA..."

การประมวลผลไฟล์ PDF

เมื่อประมวลผลไฟล์ PDF รูปแบบการตอบสนองจะแตกต่างกันเล็กน้อย:

1. การตอบสนองจะเป็น JSON array ที่มีผลลัพธ์สำหรับแต่ละหน้า
2. ผลลัพธ์แต่ละหน้าจะรวมถึง:
   • page: หมายเลขหน้า
   • info: ประกอบด้วยฟิลด์มาตรฐานทั้งหมดตามที่แสดงไว้ข้างต้น
3. ฟิลด์ process_time จะแสดงระยะเวลาการประมวลผลทั้งหมด

โครงสร้างการตอบสนอง PDF ตัวอย่าง:

[
    {
        "page": 1,
        "info": {
            "sex": "F",
            "number": "AC1062346",
            "expiration_date": "04/03/25",
            "raw_text": "P<THAPOSHNASWADIWONG<<MATHANIDA<<<<<<<<<<<<<\nAC10623466THA9307104F25030440012345678913<34",
            "personal_number": "0012345678913",
            "surname": "POSHNASWADIWONG",
            "nationality": "THA",
            "date_of_birth": "10/07/93",
            "names": "MATHANIDA",
            "country": "THA",
            "face": "iVBORw0...CYII=",
            "inference": "3.888",
            "file_name": "1676365480.3823211_thai_passport_page_1.png",
            "message": "Success",
            "status_code": 200
        }
    },
    {
        "process_time": "4.918s"
    }
]

คุณสมบัติและความสามารถ

คุณสมบัติหลัก

• การดึงข้อความจาก MRZ (Machine Readable Zone)
• การดึงรูปภาพใบหน้า
• รองรับ PDF หลายหน้า
• การแก้ไขการวางแนวภาพอัตโนมัติ
• การแบ่งส่วนภาพสำหรับภาพที่เอียง
• การตรวจสอบความถูกต้องด้วยความแม่นยำสูง

ฟิลด์ที่รองรับ

• ประเภทเอกสาร
• ประเทศที่ออก
• หมายเลขเอกสาร
• ชื่อผู้ถือ
• สัญชาติ
• วันเกิด
• เพศ
• วันหมดอายุ
• หมายเลขประจำตัว
• รูปภาพใบหน้า (base64)
• ข้อความ MRZ ดิบ
• คะแนนความถูกต้อง

API Endpoints

Endpoint	Method	คำอธิบาย	ค่าใช้จ่าย
/v3/store/ekyc/passport/v2 /passport-ocr/v2 (รุ่นเก่า)	POST	การรู้จำหนังสือเดินทางขั้นสูงด้วยความแม่นยำ 95.51% - ดึงข้อมูล MRZ และรูปภาพใบหน้า	0.75 IC ต่อหน้า
/v3/store/ekyc/passport/v1 /passport-ocr (รุ่นเก่า)	POST	การรู้จำหนังสือเดินทาง - ดึงข้อมูล MRZ และรูปภาพใบหน้า	0.75 IC ต่อหน้า

API Reference

Passport OCR Endpoints

1. Passport OCR (Version 1)

POST /v3/store/ekyc/passport/v1

ดำเนินการรู้จำตัวอักษร (OCR) บนหน้าข้อมูลส่วนตัวของหนังสือเดินทางและดึงข้อมูล MRZ

---

2. Passport OCR (Version 2)

POST /v3/store/ekyc/passport/v2

เวอร์ชันปรับปรุงพร้อมความแม่นยำที่เพิ่มขึ้น (95.51%) ดำเนินการรู้จำตัวอักษร (OCR) บนหน้าข้อมูลส่วนตัวของหนังสือเดินทางและดึงข้อมูล MRZ

Request Headers

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
apikey	string	ใช่	API Key ของคุณ

Request Body (multipart/form-data)

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
file	File	ใช่	ไฟล์รูปภาพ (JPG, PNG, PDF)
options	String	ไม่	เปิดใช้งาน "segmentation" สำหรับการประมวลผลภาพที่เอียง

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

Curl

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

Python

import requests

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

response = requests.post(url, headers=headers, files=files)
print(response.json())

JavaScript

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

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

let config = {
    method: "post",
    url: "https://api.iapp.co.th/v3/store/ekyc/passport/v2",
    headers: {
        apikey: "YOUR_API_KEY",
        ...data.getHeaders(),
    },
    data: data,
}

axios(config)
    .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/v2',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array(
    'apikey: YOUR_API_KEY'
),
CURLOPT_POSTFIELDS => array(
    'file'=> new CURLFILE('passport.jpg')
)
));

$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/v2")!
let boundary = "Boundary-\(UUID().uuidString)"

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

let imageData = try! Data(contentsOf: URL(fileURLWithPath: "passport.jpg"))

var body = Data()
body.append("--\(boundary)\r\n")
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"passport.jpg\"\r\n")
body.append("Content-Type: image/jpeg\r\n\r\n")
body.append(imageData)
body.append("\r\n--\(boundary)--\r\n")

let task = URLSession.shared.uploadTask(with: request, from: body) { data, response, error in
    if let data = data {
        let json = try? JSONSerialization.jsonObject(with: data)
        print(json ?? "")
    }
}
task.resume()

Kotlin

import okhttp3.*
import java.io.File

val client = OkHttpClient()

val file = File("passport.jpg")
val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart(
        "file",
        file.name,
        RequestBody.create(MediaType.parse("image/jpeg"), file)
    )
    .build()

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

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

Java

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.file.*;

public class PassportOCR {
    public static void main(String[] args) throws IOException {
        String boundary = "Boundary-" + System.currentTimeMillis();
        URL url = new URL("https://api.iapp.co.th/v3/store/ekyc/passport/v2");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();

        conn.setRequestMethod("POST");
        conn.setDoOutput(true);
        conn.setRequestProperty("apikey", "YOUR_API_KEY");
        conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);

        try (OutputStream os = conn.getOutputStream()) {
            byte[] fileBytes = Files.readAllBytes(Paths.get("passport.jpg"));

            os.write(("--" + boundary + "\r\n").getBytes());
            os.write(("Content-Disposition: form-data; name=\"file\"; filename=\"passport.jpg\"\r\n").getBytes());
            os.write(("Content-Type: image/jpeg\r\n\r\n").getBytes());
            os.write(fileBytes);
            os.write(("\r\n--" + boundary + "--\r\n").getBytes());
        }

        try (BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {
            String line;
            while ((line = br.readLine()) != null) {
                System.out.println(line);
            }
        }
    }
}

Dart

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

Future<void> scanPassport() async {
    var url = Uri.parse('https://api.iapp.co.th/v3/store/ekyc/passport/v2');
    var request = http.MultipartRequest('POST', url);

    request.headers['apikey'] = 'YOUR_API_KEY';

    request.files.add(
    await http.MultipartFile.fromPath(
        'file',
        'passport.jpg',
    ),
    );

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

ข้อจำกัดและแนวทางปฏิบัติที่ดีที่สุด

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 10MB
• รูปแบบที่รองรับ: JPG, PNG, PDF
• หนังสือเดินทางหนึ่งเล่มต่อภาพ
• ต้องใช้ภาพที่ชัดเจนและโฟกัส

แนวทางปฏิบัติที่ดีที่สุด

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

ความแม่นยำและประสิทธิภาพ

ความแม่นยำโดยรวม

• เวอร์ชันปัจจุบัน (2.0): 95.51%
• เวอร์ชันก่อนหน้า (1.1): 88.86%

ความแม่นยำระดับฟิลด์ (Version 1.1)

• ชื่อ: 81.93%
• นามสกุล: 90.26%
• หมายเลขเอกสาร: 84.03%
• สัญชาติ: 88.09%
• การตรวจจับใบหน้า: 100%

ความเร็วในการประมวลผล

• ภาพเดียว: 1-2 วินาที
• เอกสาร PDF: 2-3 วินาทีต่อหน้า
• เวลาเพิ่มเติมเมื่อใช้ segmentation

ปัจจัยที่มีผลต่อความแม่นยำ

• คุณภาพของภาพ
• สภาพแสง
• ตำแหน่งของเอกสาร
• ความละเอียดของภาพ
• สภาพของเอกสาร
• มุมเอียงของภาพ

ประวัติ

Version 2.0 (กุมภาพันธ์ 2023)

• เพิ่มความแม่นยำโดยรวมจาก 88.86% เป็น 95.51%
• อัปเกรดเอนจิ้น OCR ทั้งหมด
• เพิ่มการประมวลผลเบื้องต้นด้วยการแบ่งส่วนภาพสำหรับภาพที่เอียง

Version 1.1 (มกราคม 2023)

• เพิ่มการดึงรูปภาพใบหน้าเป็น base64
• เพิ่มการรองรับภาพที่เอียงเล็กน้อย
• เพิ่มการรองรับไฟล์ PDF
• เพิ่มการรองรับ PDF หลายหน้า

Version 1.0 (กุมภาพันธ์ 2022)

• เปิดตัวครั้งแรก
• รองรับหนังสือเดินทางทุกประเทศโดยใช้ MRZ
• รองรับรูปแบบภาพพื้นฐาน (PNG, JPG, JPEG)

ราคา

การดำเนินการ	Production Path	Legacy Path	ค่าใช้จ่าย IC	หน่วย	On-Premise
Passport OCR (Version 1)	/v3/store/ekyc/passport/v1	/passport-ocr	0.75 IC	ต่อ 1 คำขอ	ติดต่อเรา
Passport OCR (Version 2)	/v3/store/ekyc/passport/v2	/passport-ocr/v2	0.75 IC	ต่อ 1 คำขอ	ติดต่อเรา