TextIn - API中心

文档中心

查看文档

示例代码

API调试

接入技术服务

功能描述

车辆登记证字段识别

请求URL

https://api.textin.com/ai/service/v1/vehicle_registration_certificate

HTTP请求方法（Method）

HTTP POST

请求头说明（Request Headers）

请在HTTP请求中添加以下自定义标头（Header）。

header 名	值
x-ti-app-id	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id
x-ti-secret-code	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code

请求体说明（Request Body）

支持以下两种请求格式

1. Content-Type: application/octet-stream

要上传的图片，目前支持jpg, png, bmp, pdf, tiff, webp, 单帧gif等大部分格式.

请注意，请求体的数据格式为本地文件的二进制流，非 FormData 或其他格式。文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。

2. Content-Type: text/plain

请求体的数据格式为文本，内容为在线文件的URL链接（支持http以及https协议）。在线文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。

响应体说明（Response）

Content-Type: application/json

JSON结构说明如下：

字段名	类型	描述
code	integer	错误码，详见“错误码说明”
message	string	错误信息
duration	number	响应时间
result	object
+ type	string	当前识别证件类型，当为other的时候,代表无法识别的图片 vehicle_regist_page_mortgage:车辆登记证抵押页 vehicle_registration_certificate:车辆登记证注册页 other:其他
+ rotated_image_width	integer	正方向时图片的宽
+ rotated_image_height	integer	正方向时图片高
+ image_angle	integer	图片需要旋转多少度才能得到正方向上的图片
+ item_list	array	常规结构化结果
++ key	string	机动车登记证书编号:vehicle_registration_page_mortgage_no 转移登记-姓名/名称:vehicle_registration_page_transfer_id_name 转移登记-身份证明名称/号码:vehicle_registration_page_transfer_id_number 转移登记-获得方式:vehicle_registration_page_transfer_method_of_obtaining 转移登记-日期:vehicle_registration_page_transfer_date 抵押登记-姓名/名称:vehicle_registration_page_mortgage_id_name 抵押登记-身份证明名称/号码:vehicle_registration_page_mortgage_id_number 抵押登记-日期:vehicle_registration_page_mortgage_date 转移登记-转入地车辆管理所名称:vehicle_registration_page_transfer_department_name 转移登记-机动车登记编号:vehicle_registration_page_transfer_plate_number 解除抵押日期:vehicle_registration_page_released_date 编号:vehicle_registration_page_no 机动车所有人:vehicle_registration_owner 身份证明名称:vehicle_certification_ID_name 号码:vehicle_certification_ID_number 登记机关:registration_authority 登记日期:registration_date 机动车登记编号:vehicle_registration_number 车辆类型:vehicle_type 车辆品牌:vehicle_brand 车身颜色:vehicle_color 车辆型号:vehicle_type_number 车辆识别代号/车架号:vehicle_vin 国产/进口:domestic/import 发动机号:vehicle_engine_number 发动机型号:vehicle_engine_type 燃料种类:vehicle_fuel_type 排量:vehicle_displacement 功率:vehicle_power 制造厂名称:vehicle_manufacturer 转向形式:steering_mode 前轮距（mm）:wheel_tread_front 后轮距（mm）:wheel_tread_rear 轮胎数:vehicle_sire_number 轮胎规格:vehicle_tire_param 钢板弹簧片数:steel_spring_number 轴距（mm）:wheel_base 轴数:axle_number 外扩尺寸（mm）:vehicle_online_size 货厢内部尺寸（mm）:vehicle_internal_size 总质量（kg）:total_mass 核定载质量（kg）:permitted_weight 核定载客（人）:seating_capacity 准牵引总质量（kg）:traction_mass 驾驶室载客（人）:cab_capacity 使用性质:nature_of_usage 车辆获得方式:vehicle_acquisition_mode 车辆出厂日期:production_date 发证日期:issued_date 签发机关章:issuing_authority_stamp 是否红章:is_red_stamp
++ value	string	结构化结果字段的值
++ description	string	结构化结果字段描述
++ position	array	识别的字段在旋转后图中的坐标, 是个长度为8的数组 [0,1,2,3,4,5,6,7] (0, 1) 左上角坐标 (2, 3) 右上角坐标 (4, 5) 右下角坐标 (6, 7) 左下角坐标
++ confidence	number	字段置信度
+ transfer_register_list	array	转移登记结构化结果(抵押页)
++ key	string	转移登记结构化结果的字段转移登记-姓名/名称:vehicle_registration_page_transfer_id_name 转移登记-身份证明名称/号码:vehicle_registration_page_transfer_id_number 转移登记-获得方式:vehicle_registration_page_transfer_method_of_obtaining 转移登记日期:vehicle_registration_page_transfer_date 转移登记-转入地车辆管理所名称: vehicle_registration_page_transfer_department_name 转移登记-机动车登记编号: vehicle_registration_page_transfer_plate_number
++ value	string	结构化结果字段的值
++ position	array	识别的字段在旋转后图中的坐标, 是个长度为8的数组 [0,1,2,3,4,5,6,7] (0, 1) 左上角坐标 (2, 3) 右上角坐标 (4, 5) 右下角坐标 (6, 7) 左下角坐标
++ description	string	结构化结果的字段的描述
++ confidence	number	字段置信度
+ mortgage_register_list	array	抵押登记结构化结果
++ key	string	抵押登记结构化结果的字段抵押登记-抵押权人姓名/名称:vehicle_registration_page_mortgage_id_name 抵押登记-身份证明名称/号码:vehicle_registration_page_mortgage_id_number 抵押登记日期:vehicle_registration_page_mortgage_date
++ value	string	结构化结果字段的值
++ position	array	识别的字段在旋转后图中的坐标, 是个长度为8的数组 [0,1,2,3,4,5,6,7] (0, 1) 左上角坐标 (2, 3) 右上角坐标 (4, 5) 右下角坐标 (6, 7) 左下角坐标
++ description	string	结构化结果的字段的描述
++ confidence	number	字段置信度
+ transfer_list	array	转移登记结构化结果(注册页)
++ key	string	转移登记结构化结果的字段转移机动车所有人:vehicle_registration_owner 转移身份证明名称:vehicle_certification_ID_name 转移号码:vehicle_certification_ID_number 转移登记机关:registration_authority 转移登记日期:registration_date 转移登记编号:vehicle_registration_number
++ value	string	结构化结果字段的值
++ position	array	识别的字段在旋转后图中的坐标, 是个长度为8的数组 [0,1,2,3,4,5,6,7] (0, 1) 左上角坐标 (2, 3) 右上角坐标 (4, 5) 右下角坐标 (6, 7) 左下角坐标
++ description	string	结构化结果的字段的描述
++ confidence	number	字段置信度
+ released_register_list	array	解除抵押结构化结果
++ key	string	解除抵押结构化结果的字段解除抵押日期:vehicle_registration_page_released_date
++ value	string	结构化结果字段的值
++ position	array	识别的字段在旋转后图中的坐标, 是个长度为8的数组 [0,1,2,3,4,5,6,7] (0, 1) 左上角坐标 (2, 3) 右上角坐标 (4, 5) 右下角坐标 (6, 7) 左下角坐标
++ description	string	结构化结果的字段的描述
++ confidence	number	字段置信度

JSON结构示例

{"duration":100,"result":{"type":"vehicle_registration_certificate","rotated_image_width":1184,"rotated_image_height":817,"image_angle":270,"item_list":[{"key":"vehicle_registration_page_mortgage_date","value":"居民身份证/91320506582255512","description":"机动车登记编号","position":[0],"confidence":0.988}],"transfer_register_list":[[{"key":"vehicle_registration_page_transfer_id_name","value":"居民身份证/91320506582255512","position":[0],"description":"转移登记日期","confidence":0.988}]],"mortgage_register_list":[[{"key":"vehicle_registration_page_mortgage_date","value":"居民身份证/91320506582255512","position":[0],"description":"抵押登记日期","confidence":0.988}]],"transfer_list":[[{"key":"registration_authority","value":"上海市XX公安交警支队","position":[0],"description":"转移登记机关","confidence":0.988}]],"released_register_list":[[{"key":"vehicle_registration_page_released_date","value":"2012-01-01","position":[0],"description":"解除抵押日期","confidence":0.988}]]}}

错误码说明

错误码	描述
40101	x-ti-app-id 或 x-ti-secret-code 为空
40102	x-ti-app-id 或 x-ti-secret-code 无效，验证失败
40103	客户端IP不在白名单
40003	余额不足，请充值后再使用
40004	参数错误，请查看技术文档，检查传参
40007	机器人不存在或未发布
40008	机器人未开通，请至市场开通后重试
40301	文件类型不支持，接口会返回实际检测到的文件类型，如“当前文件类型为.gif”
40302	上传文件大小不符，文件大小不超过 10M
40303	文件类型不支持
40304	图片尺寸不符，图像宽高须介于 20 和 10000（像素）之间
40305	识别文件未上传
40400	无效的请求链接，请检查链接是否正确
30203	基础服务故障，请稍后重试
500	服务器内部错误