车辆登记证 OCR
1 IC每页
欢迎使用车辆登记证 OCR API，这是 iApp Technology Co., Ltd. 旗下的 iApp Any Documents OCR 的一部分。从陆路运输部车辆登记证 (คู่มือจดทะเบียนรถ) 中提取车辆和所有权数据，包括最新的车主条目。支持扫描的 PDF 和蓝皮书的照片。
试用演示！
入门
-
先决条件
- iApp Technology 的 API 密钥
- 文档文件：车辆登记证 (เล่มทะเบียนรถ (คู่มือจดทะเบียนรถ))
- 支持的文件格式：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/vehicle-registration/file/v3/store/ocr/vehicle-registration | POST | 从泰国车辆登记证中提取车辆和所有权数据 | 每页 1 IC |
这两种形式是等效的。此端点没有 base64 变体 — 仅支持文件上传。
请求
请求头
| 请求头 | 值 | 是否必需 |
|---|---|---|
apikey | 您的 iApp 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/vehicle-registration/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": {
"registration_date": "27 มิถุนายน 2562",
"license_plate": "1กข 1234",
"province": "กรุงเทพมหานคร",
"vehicle_type": "รถยนต์นั่งส่วนบุคคลไม่เกิน 7 คน",
"brand": "ISUZU",
"model": "mu-X",
"year": 2019,
"color": "ขาว",
"body_number": "MP1TFR85XKT000000",
"engine_number": "4JJ1XX0000",
"fuel_type": "ดีเซล",
"seating_capacity": 7,
"owner_name": "นายสมชาย ตัวอย่าง",
"owner_id": "1100000000001",
"owner_address": "123 ถนนพหลโยธิน แ ขวงจตุจักร เขตจตุจักร กรุงเทพมหานคร",
"occupant_name": null,
"occupant_id": null
},
"confidence": {
"registration_date": 0.95,
"license_plate": 0.95,
"province": 0.95,
"vehicle_type": 0.95,
"brand": 0.95,
"model": 0.95
},
"process_ms": 4120
}
],
"docs_count": 1,
"process_ms": 4300
}
iapp-input-pages 响应头报告了计费页面的数量。
支持的字段
| 字段 | 类型 | 描述 |
|---|---|---|
| registration_date | 字符串 | 注册日期 |
| license_plate | 字符串 | 车牌号码 |
| province | 字符串 | 注册省份 |
| vehicle_type | 字符串 | 车辆类型 |
| brand | 字符串 | 品牌，例如 ISUZU |
| model | 字符串 | 型号，例如 mu-X |
| year | 整数 | 型号年份（公元） |
| color | 字符串 | 颜色 |
| body_number | 字符串 | 底盘/车身号码 |
| engine_number | 字符串 | 发动机号码 |
| fuel_type | 字符串 | 燃料类型 |
| seating_capacity | 整数 | 座位数 |
| owner_name | 字符串 | 最新注册车主的姓名 |
| owner_id | 字符串 | 车主的国民身份证/法人实体 ID |
| owner_address | 字符串 | 车主地址 |
| occupant_name | 字符串 | 使用人姓名（如果适用） |
| occupant_id | 字符串 | 使用人的国民身份证/法人实体 ID（如果适用） |
错误处理
| 状态 | 含义 |
|---|---|
| 400 | 文件扩展名不受支持，或文件大于 50MB |
| 401 | 缺少或无效的 apikey |
| 402 | 信用余额不足 |
| 404 | URL 中未知的文档类型 |
| 422 | 请求中未附加文件 |
| 500 | 处理错误 — 响应包含错误代码，请引用以联系支持 |
代码示例
Python
import requests
url = "https://api.iapp.co.th/ocr/v3/vehicle-registration/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/vehicle-registration/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/vehicle-registration/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/vehicle-registration/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/vehicle-registration/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/vehicle-registration/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/vehicle-registration/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 金色评估集上进行测量 — 对真实的泰国文档（包括低分辨率照片和部分被手写字覆盖的账单）进行视觉复核的标签。
| 文档类型 | 文档数量 | 字段数量 | 准确性 |
|---|---|---|---|
| 车辆登记证 | 2 | 13 | 92.3% |
| 总体，所有六种文档类型 | 25 | 147 | 98.6% |
支持
需要帮助？联系我们：
- 邮箱：sale@iapp.co.th
- 电话：086-322-5858
- Discord：iApp Technology