OCR แบบรับรองรายการทะเบียนราษฎร

อ่านแบบรับรองรายการทะเบียนราษฎร (ท.ร. 14/1) แล้วส่งกลับข้อมูลบุคคล บิดามารดา ที่อยู่ และการรับรองของนายทะเบียน พร้อมค่าความมั่นใจรายฟิลด์

POST/ocr/v3/civil-registeration-certificate/file

และอีก 1 endpoint

ทดลองใช้

• ราคา1 ICต่อหน้า
• ให้บริการแล้ว18.8Kครั้ง

• v3.0
• ใช้งานได้

Input

OutputPOST /ocr/v3/civil-registeration-certificate/file

header

(ท้องถิ่นเขตยานนาวา) ท.ร. 14/1

nationalIdNumber

X-XXXX-XXXXX-XX-X

houseRegistrationNumber

XXXX-XXXXXX-X

name

นายสXXXXX XXXXXXXXXXX

gender

ชาย

nationality

ไทย

dateOfBirth

8 XXXXXXX 2498

age

64

residentialStatus

เจ้าบ้าน

address

XXX XXXXXXX XXX แขวงตลิ่งชัน เขตตลิ่งชัน กรุงเทพมหานคร

registrationOffice

ท้องถิ่นเขตตลิ่งชัน

footer

text: รับรองว่าเป็นรายการจากฐานข้อมูลการทะเบียนราษฎร date: 2 เดือน กันยายน พ.ศ. 2567 registrar: นายXXXXX XXXXXXX

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Responseendpoint อื่น: /civil-registeration-certificate ดูที่ Request

Request

curl -X POST https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@certificate.jpg"

Response

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

{
  "message": "success",
  "processed": {
    "header": "(ท้องถิ่นเขตยานนาวา) ท.ร. 14/1",
    "nationalIdNumber": "X-XXXX-XXXXX-XX-X",
    "houseRegistrationNumber": "XXXX-XXXXXX-X",
    "name": "นายสXXXXX XXXXXXXXXXX",
    "gender": "ชาย",
    "nationality": "ไทย",
    "dateOfBirth": "8 XXXXXXX 2498",
    "age": 64,
    "residentialStatus": "เจ้าบ้าน",
    "address": "XXX XXXXXXX XXX แขวงตลิ่งชัน เขตตลิ่งชัน กรุงเทพมหานคร",
    "registrationOffice": "ท้องถิ่นเขตตลิ่งชัน",
    "footer": { "text": "รับรองว่าเป็นรายการจากฐานข้อมูลการทะเบียนราษฎร",
                "date": "2 เดือน กันยายน พ.ศ. 2567", "registrar": "นายXXXXX XXXXXXX" }
  },
  "confidence": { "nationalIdNumber": 0.95, "name": 0.95, "dateOfBirth": 0.9, "address": 0.95 }
}

Request

ส่งเป็น multipart/form-data ไปที่ /file คิด 1 IC ต่อหน้า และ PDF ต้องมีหน้าเดียว

Headers

apikeystringrequired

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

Body

filefilerequired

แบบรับรอง ไฟล์ JPEG, PNG หรือ PDF ไม่เกิน 10 MB

return_imageboolean

ใส่ true เพื่อรับภาพที่ประมวลผลแล้วกลับเป็น Base64

return_ocrboolean

ใส่ true เพื่อรับข้อความ OCR ดิบด้วย

Endpoint	รับ
/ocr/v3/civil-registeration-certificate/file	ไฟล์

บริการเดียวกันนี้เรียกผ่าน /v3/store/ocr/civil-registeration-certificate ได้ด้วย

Response

ถ้าใส่ return_ocr เป็น true จะได้ข้อความ OCR ดิบใน raw มาด้วย

processedobject

ฟิลด์ที่อ่านได้จากเอกสาร

processed.headerprocessed.title

เลขแบบฟอร์มและชื่อเอกสาร

processed.nationalIdNumberprocessed.houseRegistrationNumber

เลขบัตรประชาชน 13 หลัก และเลขรหัสประจำบ้าน

processed.nameprocessed.genderprocessed.nationalityprocessed.dateOfBirthprocessed.age

ข้อมูลบุคคล

processed.residentialStatusstring

สถานภาพในบ้าน

processed.mothersNameprocessed.mothersNationalityprocessed.fathersNameprocessed.fathersNationality

บิดามารดา

processed.addressprocessed.registrationOfficeprocessed.moveInDate

ที่อยู่ สำนักทะเบียน และวันย้ายเข้า

processed.additionalNotesprocessed.remarksprocessed.lastUpdated

หมายเหตุ ข้อความรับรอง และวันปรับปรุงล่าสุด

processed.footerobject

การรับรอง

processed.footer.textstring

processed.footer.datestring

processed.footer.registrarstring

messagestring

ข้อความสถานะ

confidenceobject

ความมั่นใจรายฟิลด์ 0 ถึง 1

รหัสสถานะ

รหัส	ความหมาย
400	พารามิเตอร์หรือรูปแบบไฟล์ไม่ถูกต้อง
404	ไม่รู้จัก endpoint
500	ประมวลผลไม่สำเร็จ

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

ผลการทดสอบ

วัดบนชุดทดสอบแบบรับรองรายการทะเบียนราษฎร 1,000 ฉบับ

รายการ	ผล
เลขประจำตัว	99.5%
ชื่อ	99.2%
วันที่	98.7%
ที่อยู่	97.8%
ทุกฟิลด์	98.8%
เวลาต่อฉบับ	ปกติ 5–10 วินาที เปอร์เซ็นไทล์ที่ 95 อยู่ที่ 12 วินาที สูงสุด 15 วินาที

รูปแบบมาตรฐานอ่านได้ 99% ขึ้นไป รูปแบบไม่มาตรฐาน 95% ขึ้นไป ส่วนที่เขียนด้วยลายมือ 90% ขึ้นไป

ข้อจำกัด

• เรียกได้ 10 ครั้งต่อวินาทีต่อ API key
• ความแม่นยำลดลงเมื่อความละเอียดต่ำกว่า 300 dpi แสงไม่ดี หรือเอกสารชำรุด สีจาง หรือมีการแก้ด้วยลายมือ

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

บริการเป็นไปตาม GDPR และ PDPA

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
3.0	27 ธ.ค. 2567	เปิดให้บริการ