🪪✏️ การตรวจจับลายเซ็นจากรูปถ่ายบัตรประชาชนไทย

1.25 ICต่อหน้า

v1.0 Active พ.ศ. 2566 POST /v3/store/ekyc/thai-national-id-card-with-signature

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

ลองใช้ Demo!

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, HEIC, HEIF
   • ขนาดไฟล์สูงสุด: 2MB

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

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

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

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

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

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

วิธีรับคีย์ API?

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

ตัวอย่าง

หมายเหตุ

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

คำขอ

curl -X POST https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature \
-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

API Endpoints

Endpoint	Method	คำอธิบาย	ค่าบริการ
POST /v3/store/ekyc/thai-national-id-card-with-signature Legacy: /thai-national-id-card-with-signature/front Legacy: /thai-national-id-card/copy	POST	ดึงข้อมูลโดยละเอียดจากสำเนาบัตรประชาชนไทยที่ถ่ายรูปและตรวจจับลายเซ็น	1.25 IC ต่อหน้า

ฟิลด์การตอบกลับ

ฟิลด์	ประเภท	คำอธิบาย
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 (เร็วๆ นี้)
reason_code_id_card_signature	Integer	0 - ไม่พบลายเซ็นบนกระดาษ, 1 - พบลายเซ็นบนกระดาษ
reason_codename_id_card_signature	Integer	รหัสอธิบาย reason_code_id_card_signature (เร็วๆ นี้)
request_id	String	รหัสคำขอจาก API Gateway
surname_en	String	นามสกุล (ภาษาอังกฤษ)
surname_th	String	นามสกุล (ภาษาไทย)

เอกสารอ้างอิง API

Endpoint Photographed Thai National ID Card With Signature Detection

1. Photographed Thai National ID Card With Signature Detection

POST /v3/store/ekyc/thai-national-id-card-with-signature

ดึงข้อมูลโดยละเอียดจากสำเนาบัตรประชาชนไทยที่ถ่ายรูปและตรวจจับลายเซ็น

---

Request Headers

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

Request Body (multipart/form-data)

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
file	File	ใช่	ไฟล์รูปภาพสำเนาบัตรประชาชนไทยที่ถ่ายรูป

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

Curl

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

Python

import requests

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

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

# เพิ่มคีย์ API ในส่วนหัว
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/v3/store/ekyc/thai-national-id-card-with-signature", {
    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/v3/store/ekyc/thai-national-id-card-with-signature',
    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/v3/store/ekyc/thai-national-id-card-with-signature")!
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/v3/store/ekyc/thai-national-id-card-with-signature")
    .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/v3/store/ekyc/thai-national-id-card-with-signature");
        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');

    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 route
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	ไม่พบ ID card ในภาพ
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	2566	เปิดตัวครั้งแรกพร้อมการตรวจจับลายเซ็น

ราคา

ชื่อบริการ AI API	Endpoint	IC ต่อคำขอ	On-Premise
OCR สำเนาบัตรประชาชนไทยที่ถ่ายรูป [v1.0]	iapp-photographed-copy-idcard-ocr	1.25 IC/นาที	ติดต่อ