🪪✏️ การถ่ายภาพบัตรประชาชนไทยพร้อมตรวจจับลายเซ็น (ID card with Signature OCR)

🪪✏️ บริการ AI แกะข้อความจากรูปสำเนาบัตรประชาชน

ยินดีต้อนรับสู่ Photographed Thai National ID Card With Signature Detection API ผลิตภัณฑ์ AI ที่พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด API ของเราออกแบบมาเพื่อดึงข้อมูลข้อความจากสำเนาภาพถ่ายบัตรประชาชนไทย (ทั้งสีและขาวดำ) และตรวจจับลายเซ็น ระบบสามารถระบุตำแหน่งบัตรประชาชนในภาพได้โดยอัตโนมัติและส่งคืนข้อมูลข้อความที่ถูกต้อง เช่น เลขประจำตัวประชาชน ชื่อ นามสกุล วันเดือนปีเกิด และวันหมดอายุ ในรูปแบบ JSON

Try Demo

Visit our API Portal to test the Photographed Thai National ID Card With Signature Detectiont OCR API with your own images.

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

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

   • API key จาก ไอแอพพ์เทคโนโลยี
   • สำเนาภาพถ่ายบัตรประชาชนไทย
   • รูปแบบไฟล์ที่รองรับ: JPEG, JPG, PNG, HEIC, HEIF
   • ขนาดไฟล์สูงสุด: 2MB

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

   • เวลาในการประมวลผล: 1-3 วินาทีต่อภาพ
   • การตรวจจับและการครอบตัดบัตรโดยอัตโนมัติ
   • รองรับทั้งสำเนาสีและขาวดำ

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

   • การดึงข้อมูลรายละเอียดต่างๆ รวมถึง:
     • เลขประจำตัวประชาชน
     • ชื่อเต็ม (ภาษาไทยและภาษาอังกฤษ)
     • วันเดือนปีเกิด
     • ที่อยู่
     • วันหมดอายุ
   • การตรวจจับลายเซ็น
   • รูปแบบการตอบสนอง JSON ที่ยืดหยุ่น

4. ความปลอดภัยและการปฏิบัติตามกฎระเบียบ

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

วิธีรับ API Key?

กรุณาเยี่ยมชม API Portal เพื่อดู API key ที่มีอยู่ของคุณหรือขอ API key ใหม่

ตัวอย่าง

หมายเหตุ

API นี้ได้รับการปรับให้เหมาะสมสำหรับ OCR จากสำเนาบัตรประชาชนที่พิมพ์ สำหรับ OCR จากบัตรประชาชนจริง โปรดใช้ Thai National ID Card OCR แทน

คำขอ

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

การตอบสนอง

{
"address_district": "บางละมุง",
"address_full": "XXXXXX XXXXXX ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
"address_number": "XXXXXX XXXXXX",
"address_postal_code": "20150",
"address_province": "ชลบุรี",
"address_subdistrict": "ต.หนองปรือ",
"date_of_birth": "XX มี.ค. 2500",
"date_of_expire": "XX มี.ค. 2568",
"file_name_id_card": "front.jpg",
"fullname_en": "Mrs. XXXXXX Lopez",
"fullname_th": "นาง XXXXXX โลเปช",
"init_en": "Mrs.",
"init_th": "นาง",
"name_en": "XXXXXX",
"name_th": "XXXXXX",
"national_id": "34117XXXXXX334",
"process_time": 2.1,
"reason_code_api": 200,
"reason_code_id_card": 1,
"reason_code_id_card_national_id": 1,
"reason_code_id_card_signature": 0,
"reason_codename_id_card_signature": 1,
"request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx",
"surname_en": "Lopez",
"surname_th": "โลเปช"
}

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

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

• การตรวจจับบัตรประชาชนในภาพโดยอัตโนมัติ
• รองรับทั้งสำเนาสีและขาวดำ
• การตรวจจับลายเซ็น
• เวลาในการประมวลผลที่รวดเร็ว (1-3 วินาที)
• รองรับรูปแบบไฟล์หลายแบบ

ข้อกำหนดของภาพ

• ขนาดบัตรขั้นต่ำ: ความกว้าง 600px, ความสูง 400px
• ขนาดไฟล์สูงสุด: 2MB
• รูปแบบที่รองรับ: JPEG, JPG, PNG, HEIC, HEIF

ฟิลด์การตอบสนอง

ฟิลด์	ชนิด	คำอธิบาย
address_district	String	ชื่ออำเภอ
address_full	String	ที่อยู่ทั้งหมด
address_number	String	บ้านเลขที่
address_postal_code	String	รหัสไปรษณีย์
address_province	String	ชื่อจังหวัด
address_subdistrict	String	ชื่อตำบล
date_of_birth	String	วันเดือนปีเกิด (ภาษาไทย)
date_of_expire	String	วันหมดอายุ (ภาษาไทย)
file_name_id_card	String	ชื่อไฟล์ภาพ
fullname_en	String	ชื่อและนามสกุล (ภาษาอังกฤษ)
fullname_th	String	ชื่อและนามสกุล (ภาษาไทย)
init_en	String	คำนำหน้าชื่อ (ภาษาอังกฤษ)
init_th	String	คำนำหน้าชื่อ (ภาษาไทย)
name_en	String	ชื่อ (ภาษาอังกฤษ)
name_th	String	ชื่อ (ภาษาไทย)
national_id	String	เลขประจำตัวประชาชน
process_time	Float	เวลาในการประมวลผล (วินาที)
reason_code_api	Integer	รหัสสถานะการตอบสนอง
reason_code_id_card	Integer	0 - ไม่พบบัตรประชาชนในภาพ, 1 - พบบัตรประชาชนในภาพ
reason_code_id_card_national_id	Integer	0 - ไม่พบเลขประจำตัวประชาชน, 1 - พบเลขประจำตัวประชาชน
reason_codename_id_card	Integer	รหัสอธิบาย reason_code_id_card_national_id. (TODO)
reason_code_id_card_signature	Integer	0 - ไม่พบลายเซ็นบนกระดาษ, 1 - พบลายเซ็นบนกระดาษ
reason_codename_id_card_signature	Integer	รหัสอธิบาย reason_code_id_card_signature. (TODO)
request_id	String	Request ID จาก API Gateway
surname_en	String	นามสกุล (ภาษาอังกฤษ)
surname_th	String	นามสกุล (ภาษาไทย)

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

Python

import requests

url = "https://api.iapp.co.th/thai-national-id-card-with-signature/front"
api_key = "YOUR_API_KEY"

# เตรียมไฟล์ภาพ
files = {
    'file': ('idcard.jpg', open('path/to/idcard.jpg', 'rb'), 'image/jpeg')
}

# เพิ่ม API key ลงในส่วนหัว
headers = {
    'apikey': api_key
}

# ทำการร้องขอ
response = requests.post(url, headers=headers, files=files)

# พิมพ์ผลลัพธ์
print(response.json())

JavaScript

// ใช้ Fetch API
const formData = new FormData();
formData.append('file', fileInput.files[0]);

fetch('https://api.iapp.co.th/thai-national-id-card-with-signature/front', {
    method: 'POST',
    headers: {
        'apikey': 'YOUR_API_KEY'
    },
    body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

PHP

<?php
$curl = curl_init();

$file = new CURLFile('path/to/idcard.jpg', 'image/jpeg', 'idcard.jpg');

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.iapp.co.th/thai-national-id-card-with-signature/front',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY'
    ],
    CURLOPT_POSTFIELDS => [
        'file' => $file
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/thai-national-id-card-with-signature/front")!
var request = URLRequest(url: url)
request.httpMethod = "POST"

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

let imageData = try! Data(contentsOf: URL(fileURLWithPath: "path/to/idcard.jpg"))

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

request.httpBody = body

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

Kotlin

import okhttp3.*

val client = OkHttpClient()

val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart(
        "file",
        "idcard.jpg",
        File("path/to/idcard.jpg")
            .asRequestBody("image/jpeg".toMediaTypeOrNull())
    )
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/thai-national-id-card-with-signature/front")
    .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;

public class IDCardAPI {
    public static void main(String[] args) throws IOException {
        String boundary = "Boundary-" + System.currentTimeMillis();
        
        URL url = new URL("https://api.iapp.co.th/thai-national-id-card-with-signature/front");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setDoOutput(true);
        conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);
        conn.setRequestProperty("apikey", "YOUR_API_KEY");
        
        try (OutputStream os = conn.getOutputStream()) {
            File file = new File("path/to/idcard.jpg");
            writeMultipartFile(os, "file", file, boundary);
            
            os.write(("--" + boundary + "--\r\n").getBytes());
        }
        
        try (BufferedReader br = new BufferedReader(
                new InputStreamReader(conn.getInputStream()))) {
            String line;
            while ((line = br.readLine()) != null) {
                System.out.println(line);
            }
        }
    }
    
    private static void writeMultipartFile(OutputStream os, String name, File file, String boundary) 
            throws IOException {
        os.write(("--" + boundary + "\r\n").getBytes());
        os.write(("Content-Disposition: form-data; name=\"" + name + "\"; filename=\"" + 
                file.getName() + "\"\r\n").getBytes());
        os.write("Content-Type: image/jpeg\r\n\r\n".getBytes());
        
        try (FileInputStream fis = new FileInputStream(file)) {
            byte[] buffer = new byte[4096];
            int length;
            while ((length = fis.read(buffer)) > 0) {
                os.write(buffer, 0, length);
            }
            os.write("\r\n".getBytes());
        }
    }
}

Dart

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

Future<void> uploadIDCard() async {
    var url = Uri.parse('https://api.iapp.co.th/thai-national-id-card-with-signature/front');
    
    var request = http.MultipartRequest('POST', url);
    request.headers['apikey'] = 'YOUR_API_KEY';
    
    request.files.add(
    await http.MultipartFile.fromPath(
        'file',
        'path/to/idcard.jpg',
    ),
    );
    
    var response = await request.send();
    var responseBody = await response.stream.bytesToString();
    
    print(responseBody);
}

รหัสข้อผิดพลาด

รหัสการตรวจจับบัตรประชาชน

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
1	pass	มั่นใจในเนื้อหาที่อ่านได้
0	manual check	ไม่มั่นใจในเนื้อหา ต้องตรวจสอบด้วยตนเอง

รหัสการตรวจจับลายเซ็น

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
1	pass	พบลายเซ็นบนกระดาษ
0	manual check	ไม่พบลายเซ็นหรือต้องตรวจสอบ

รหัสการตอบสนอง API

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
200	SUCCESS	ร้องขอสำเร็จ
404	REQUESTED_URL_NOT_FOUND	ไม่พบเส้นทาง API
405	METHOD_NOT_ALLOWED	วิธี HTTP ไม่ถูกต้อง
413	IMAGE_FILE_IS_TOO_LARGE	ไฟล์เกินขีดจำกัด 2MB
414	NO_FILE_ATTACHED	ไม่มีไฟล์ในคำขอ
415	INVALID_IMAGE_SIZE	ขนาดภาพไม่ถูกต้อง
420	NO_ID_CARD_FOUND	ไม่พบบัตรประชาชนในภาพ
421	IMAGE_ERROR_UNSUPPORTED_FORMAT	รูปแบบภาพไม่รองรับหรือเสียหาย
422	INVALID_IMAGE_SIZE	ไม่ตรงตามข้อกำหนดขนาดภาพ
427	LONG_TIME_TO_PROCESS	เซิร์ฟเวอร์ประมวลผลหมดเวลา
428	LONG_TIME_TO_REQUEST	คิวหมดเวลา
560	SERVER_IS_BUSY	เซิร์ฟเวอร์มีภาระมาก ต้องลองใหม่
563	ID_CARD_API_NOT_SUPPORT_THIS_IMAGE	ข้อผิดพลาดในการประมวลผล

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

1. คุณภาพของภาพ

   • ตรวจสอบให้แน่ใจว่ามีแสงสว่างเพียงพอ
   • หลีกเลี่ยงภาพเบลอ
   • ให้บัตรประชาชนมองเห็นได้ชัดเจน

2. การประมวลผล

   • ตรวจสอบรหัสเหตุผลในการตอบสนอง
   • ตรวจสอบข้อมูลที่ดึงมา
   • จัดการข้อผิดพลาดอย่างเหมาะสม

3. ความปลอดภัย

   • เก็บรักษา API key อย่างปลอดภัย
   • ตรวจสอบไฟล์อินพุต
   • ปฏิบัติตามแนวทางการปกป้องข้อมูล

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

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

• ความแม่นยำในการดึงข้อความ: 98.13% ในระดับอักขระ
• ความแม่นยำในการตรวจจับลายเซ็น: 96.5%
• ความแม่นยำเฉพาะฟิลด์แตกต่างกันไปตามประเภทเนื้อหา

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

• เฉลี่ย: 1-3 วินาทีต่อภาพ
• ปัจจัยที่มีผลต่อความเร็ว:
  • ความละเอียดของภาพ
  • ขนาดไฟล์
  • ภาระของเซิร์ฟเวอร์
  • สภาพเครือข่าย

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

1. คุณภาพของภาพ

   • ความละเอียด (แนะนำขั้นต่ำ 300 DPI)
   • สภาพแสง
   • ความคมชัดของโฟกัส
   • ความคมชัดของสี

2. สภาพของเอกสาร

   • ความเสียหายทางกายภาพหรือการสึกหรอ
   • การสะท้อนแสงหรือแสงจ้า
   • ความชัดเจนและความสามารถในการอ่านข้อความ
   • การมองเห็นลายเซ็น

3. สภาพการจับภาพ

   • มุมกล้อง
   • เสียงรบกวนพื้นหลัง
   • เงา
   • ภาพเบลอเนื่องจากการเคลื่อนไหว

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

เวอร์ชัน	วันที่เผยแพร่	คุณสมบัติหลัก
1.0	2023	การเปิดตัวครั้งแรกพร้อมการตรวจจับลายเซ็น