泰国民事登记证明 OCR

读取泰国民事登记证明（ท.ร. 14/1），返回本人、父母、地址及登记官的证明信息，各字段附置信度。

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

另有 1 个端点

试一试

• 价格1 IC每页
• 累计调用18.8K次

• v3.0
• 运行中

输入

输出POST /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

全部字段见“响应”一节其他端点：/civil-registeration-certificate 见请求

请求

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

响应

200成功。字段在"响应"一节说明。

{
  "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 }
}

请求

以 multipart/form-data 发送到 /file。每页 1 IC；PDF 须为单页。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

证明。JPEG、PNG 或 PDF，最大 10 MB。

return_imageboolean

设为 true 时以 Base64 返回处理后的图像。

return_ocrboolean

设为 true 时附带原始 OCR 文本。

端点	接受
/ocr/v3/civil-registeration-certificate/file	文件

同一服务也可通过 /v3/store/ocr/civil-registeration-certificate 调用。

响应

return_ocr 设为 true 时，响应另含 raw，即 OCR 原始文本。

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	未知端点
500	处理失败

详情

实测

在 1,000 份泰国民事登记证明的基准集上测得。

指标	结果
编号	99.5%
姓名	99.2%
日期	98.7%
地址	97.8%
全部字段	98.8%
每份耗时	典型 5–10 秒，第 95 百分位 12 秒，最长 15 秒

标准版式识别率 99% 以上，非标准版式 95% 以上，手写部分 90% 以上。

限制

• 每个 API 密钥每秒 10 次请求。
• 分辨率低于 300 dpi、光线差，或文件破损、褪色、有手写修改时，准确率下降。

数据处理

服务符合 GDPR 与 PDPA。

更新日志

版本	日期	变更
3.0	2024 年 12 月 27 日	首次发布。