NCB 信用报告 OCR

读取国家信用局报告，返回报告元数据、数据所有者身份以及每个信贷账户的摘要。

POST/ocr/v3/ncb-credit-report/file试一试

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

• v1.0
• 运行中

输入

输出POST /ocr/v3/ncb-credit-report/file

report_number

123456789

reference_number

MOBILE_APP-001

query_date

24 ต.ค. 2562 11:09:43

id_card_number

1100000000001

full_name

นาย สมชาย ตัวอย่าง

date_of_birth

11 เม.ย. 2529

total_accounts

6

accounts_under_dispute

0

accounts

lender_name: ธนาคารตัวอย่าง credit_type: สินเชื่อที่อยู่อาศัย account_status: ปกติ credit_limit: 3000000 outstanding_balance: 2500000

全部字段见“响应”一节

请求

curl -X POST "https://api.iapp.co.th/ocr/v3/ncb-credit-report/file" \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "target_lang=th" \
  -F "include_confidence=true"

响应

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

{
    "docs": [
        {
            "message": "success",
            "raw": {},
            "processed": {
                        "report_number": "123456789",
                        "reference_number": "MOBILE_APP-001",
                        "query_date": "24 ต.ค. 2562 11:09:43",
                        "id_card_number": "1100000000001",
                        "full_name": "นาย สมชาย ตัวอย่าง",
                        "date_of_birth": "11 เม.ย. 2529",
                        "total_accounts": 6,
                        "accounts_under_dispute": 0,
                        "accounts": [
                                    {
                                                "lender_name": "ธนาคารตัวอย่าง",
                                                "credit_type": "สินเชื่อที่อยู่อาศัย",
                                                "account_status": "ปกติ",
                                                "credit_limit": 3000000,
                                                "outstanding_balance": 2500000
                                    }
                        ]
            },
            "confidence": {
                        "report_number": 0.95,
                        "reference_number": 0.95,
                        "query_date": 0.95,
                        "id_card_number": 0.95,
                        "full_name": 0.95,
                        "date_of_birth": 0.95
            },
            "process_ms": 4120
        }
    ],
    "docs_count": 1,
    "process_ms": 4300
}

请求

multipart/form-data，仅支持文件上传，没有 Base64 形式。PDF 逐页读取，每页计费。

请求头

apikeystring必填

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

请求体

filefile必填

报告。PDF、JPEG、PNG 或 WEBP，最大 50 MB。可重复：一次请求多份文档。

return_ocrboolean

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

target_langstring

提取值的语言：th（默认）、en 或 auto（与文档语言一致）。

include_confidenceboolean

默认 true：每个字段附 0.00 至 1.00 的置信度。

/v3/store/ocr/ncb-credit-report 是 store 前缀下的同一端点。

响应

响应头 iapp-input-pages 为计费页数。

docsarray

每份读取的文档一项

docs.processedobject

从文档读取的字段

docs.processed.report_numberdocs.processed.reference_number

报告编号与参考编号

docs.processed.query_datestring

请求报告的日期和时间

docs.processed.id_card_numberdocs.processed.full_namedocs.processed.date_of_birth

数据所有者：13 位身份证号、姓名、出生日期

docs.processed.total_accountsdocs.processed.accounts_under_dispute

信贷账户总数，以及争议中的账户数

docs.processed.accountsarray

每个账户一条

docs.processed.accounts.lender_namestring

docs.processed.accounts.credit_typestring

docs.processed.accounts.account_statusstring

docs.processed.accounts.credit_limitinteger

docs.processed.accounts.outstanding_balanceinteger

docs.messagestring

状态信息

docs.rawobject

原始 OCR 文本，按需返回

docs.confidenceobject

各字段置信度，0 到 1

docs.process_msinteger

处理耗时，毫秒

docs_countinteger

读取的文档数

process_msinteger

处理耗时，毫秒

状态码

代码	含义
400	不支持的文件扩展名，或文件超过 50 MB
404	URL 中的文档类型未知
422	未附加文件
500	处理错误；响应中含可向支持团队引用的代码

详情

实测

在内部评估集上测得的字段级准确率：真实泰国文档，标注经人工复核，包含低分辨率照片和被手写部分遮盖的账单。

指标	结果
NCB 信用报告，5 份文档，19 个字段	100%
全部六种文档类型，25 份文档，147 个字段	98.6%

限制

• 仅提取上述字段。
• 扫描质量差、反光或手写覆盖印刷内容会降低准确率。优先使用原始 PDF，或在均匀光线下正对拍摄、以 300 dpi 以上扫描，并将低置信度字段转人工复核。

数据处理

依 PDPA 与 GDPR 取得同意并告知当事人，由作为数据控制者的您负责。