📊 NCB 信用报告 OCR

1 IC每页

v1.0 激活 2026年7月 POST /ocr/v3/ncb-credit-report/file

欢迎使用 NCB 信用报告 OCR API，这是艾艾普科技（iApp Technology Co., Ltd.）的艾艾普文档 OCR（iApp Any Documents OCR）的一部分。该 API 可以从国家信用局（National Credit Bureau / บริษัท ข้อมูลเครดิตแห่งชาติ）的报告中提取报告元数据、所有者身份信息以及每个账户的摘要，包括多页 PDF 报告。

立即试用！

试用 AI 演示

登录或创建免费账户来使用此 AI 服务演示并探索我们强大的 API。

注册即可获得 100 积分 (IC) 免费赠送！

优惠截止至 2025 年 12 月 31 日

免费创建账户登录

Example Images (Click to try)

API Key

Endpoint URL

cURL Command

上传 NCB 信用报告

入门指南

先决条件
- 来自艾艾普科技（iApp Technology）的 API 密钥
- 文档文件：NCB 信用报告 (รายงานข้อมูลเครดิต (เครดิตบูโร))
- 支持的文件格式：PDF、JPG、JPEG、PNG、WEBP
- 最大文件大小：50MB
快速入门
- 单次 POST 请求，使用 multipart/form-data
- 结构化的 JSON 输出，包含每个字段的置信度得分
- 多页 PDF 将合并到一个 docs 条目中。
主要功能
- 字段级提取，带置信度评分
- 通过 target_lang 支持泰语和英语输出
- 可选的原始 OCR 文本输出，通过 return_ocr
- 可处理照片和扫描的 PDF
安全与合规
- 符合 GDPR 和 PDPA
- 安全的 API 端点
- 处理后不保留数据

如何获取 API 密钥？

请访问 API 密钥管理页面查看您现有的 API 密钥或申请新密钥。

API 端点

端点	方法	描述	费用
`/ocr/v3/ncb-credit-report/file` /v3/store/ocr/ncb-credit-report	POST	从 NCB 信用报告中提取报告元数据、身份信息和每个账户的摘要	每页 1 IC

两种形式是等效的。此端点没有 base64 变体 — 仅支持文件上传。

请求

请求头

标头	值	是否必需
`apikey`	您的艾艾普 API 密钥	是

请求体 (multipart/form-data)

参数	类型	默认值	描述
`file`	文件 (可重复)	—	必需。文档文件。PDF 页面将自动处理。
`return_ocr`	布尔值	`false`	在响应中包含原始 OCR 文本。
`target_lang`	字符串	`th`	提取值的语言：`th` 或 `en`。
`include_confidence`	布尔值	`true`	包含每个字段的置信度得分 (0.00–1.00)。

cURL

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"

响应

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

iapp-input-pages 响应头报告了计费页面的数量。

支持的字段

字段	类型	描述
report_number	字符串	报告编号
reference_number	字符串	参考编号
query_date	字符串	请求报告的日期和时间
id_card_number	字符串	数据所有者的 13 位泰国国民身份证号码
full_name	字符串	数据所有者的全名
date_of_birth	字符串	出生日期
total_accounts	整数	信用账户总数
accounts_under_dispute	整数	争议中的账户数量
accounts	数组	每个账户的摘要 — 每个包含贷方名称、信用类型、账户状态、信用额度、未偿余额

错误处理

状态	含义
400	不支持的文件扩展名，或文件大小超过 50MB
401	缺少或无效的 `apikey`
402	信用余额不足
404	URL 中的文档类型未知
422	请求未附加文件
500	处理错误 — 响应包含错误代码，请在联系支持时提供

代码示例

Python

import requests

url = "https://api.iapp.co.th/ocr/v3/ncb-credit-report/file"
headers = {"apikey": "YOUR_API_KEY"}
files = {"file": open("document.pdf", "rb")}
data = {"target_lang": "th", "include_confidence": "true"}

response = requests.post(url, headers=headers, files=files, data=data)
result = response.json()
print(result["docs"][0]["processed"])
print(result["docs"][0]["confidence"])

JavaScript

const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("target_lang", "th");
form.append("include_confidence", "true");

const res = await fetch("https://api.iapp.co.th/ocr/v3/ncb-credit-report/file", {
  method: "POST",
  headers: { apikey: "YOUR_API_KEY" },
  body: form,
});
const result = await res.json();
console.log(result.docs[0].processed);

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.iapp.co.th/ocr/v3/ncb-credit-report/file");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["apikey: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    "file" => new CURLFile("/path/to/document.pdf"),
    "target_lang" => "th",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Java

OkHttpClient client = new OkHttpClient();

RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", "document.pdf",
        RequestBody.create(new File("/path/to/document.pdf"),
            MediaType.parse("application/pdf")))
    .addFormDataPart("target_lang", "th")
    .build();

Request request = new Request.Builder()
    .url("https://api.iapp.co.th/ocr/v3/ncb-credit-report/file")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

Swift

let url = URL(string: "https://api.iapp.co.th/ocr/v3/ncb-credit-report/file")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")

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

var data = Data()
let fileData = try Data(contentsOf: URL(fileURLWithPath: "/path/to/document.pdf"))
data.append("--\(boundary)\r\n".data(using: .utf8)!)
data.append("Content-Disposition: form-data; name=\"file\"; filename=\"document.pdf\"\r\n\r\n".data(using: .utf8)!)
data.append(fileData)
data.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)

URLSession.shared.uploadTask(with: request, from: data) { responseData, _, _ in
    if let responseData, let json = String(data: responseData, encoding: .utf8) {
        print(json)
    }
}.resume()

Kotlin

val client = OkHttpClient()

val body = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart(
        "file", "document.pdf",
        File("/path/to/document.pdf").asRequestBody("application/pdf".toMediaType())
    )
    .addFormDataPart("target_lang", "th")
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/ocr/v3/ncb-credit-report/file")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body?.string())
}

Dart

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

final request = http.MultipartRequest(
  'POST',
  Uri.parse('https://api.iapp.co.th/ocr/v3/ncb-credit-report/file'),
);
request.headers['apikey'] = 'YOUR_API_KEY';
request.fields['target_lang'] = 'th';
request.files.add(
  await http.MultipartFile.fromPath('file', '/path/to/document.pdf'),
);

final response = await request.send();
print(await response.stream.bytesToString());

限制与最佳实践

限制

单次请求最大文件大小 50MB
支持的格式：PDF、JPG、JPEG、PNG、WEBP
准确性取决于图像质量 — 严重退化的扫描件、眩光和手写字覆盖在印刷值上会降低字段级准确性
提取仅限于上述字段

最佳实践

如果有原始 PDF，请优先使用 PDF 而不是照片
从正面拍摄整个文档，并确保光线均匀
扫描件使用至少 300 DPI
检查每个字段的 confidence 分数，并将低置信度值发送给人工审核
在支持的情况下，一次请求中发送多个文档以减少往返次数

准确性与性能

字段级提取准确性在内部 ChindaOCR-M3 金色评估集上进行测量 — 对真实泰语文档（包括低分辨率照片和部分被手写字遮挡的账单）进行视觉重新验证的标签。

文档类型	文档数量	字段数量	准确性
NCB 信用报告	5	19	100%
总体，所有六种文档类型	25	147	98.6%

支持

需要帮助？请联系我们：

邮箱：sale@iapp.co.th
电话：086-322-5858
Discord：艾艾普科技 (iApp Technology)

📊 NCB 信用报告 OCR

立即试用！

试用 AI 演示

Example Images (Click to try)

入门指南

API 端点

请求

请求头

请求体 (multipart/form-data)

cURL

响应

支持的字段

错误处理

代码示例

Python

JavaScript

PHP

Java

Swift

Kotlin

Dart

限制与最佳实践

限制

最佳实践

准确性与性能

支持

ChindaX

SpeechFlow

ChindaGO

立即试用！​

试用 AI 演示

Example Images (Click to try)

入门指南​

API 端点​

请求​

请求头​

请求体 (multipart/form-data)​

cURL​

响应​

支持的字段​

错误处理​

代码示例​

Python​

JavaScript​

PHP​

Java​

Swift​

Kotlin​

Dart​

限制与最佳实践​

限制​

最佳实践​

准确性与性能​

支持​

立即试用！

入门指南

API 端点

请求

请求头

请求体 (multipart/form-data)

cURL

响应

支持的字段

错误处理

代码示例

Python

JavaScript

PHP

Java

Swift

Kotlin

Dart

限制与最佳实践

限制

最佳实践

准确性与性能

支持