接口描述
对上传的机动车登记证书图片进行OCR识别,返回机动车登记证书上的信息。
【注】套餐暂时使用:身份核验服务-身份证OCR识别子产品
接口
/v2/identity/auth/api/ocr/vehicleregcert
请求方式
POST
请求头
提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。
方式一:请求签名鉴权(优先推荐)
参数名称 | 类型 | 必选 | 参数说明 |
X-Tsign-Open-App-Id | string | 是 | 项目ID |
Content-Type | string | 是 | application/json;charset=UTF-8 |
X-Tsign-Open-Ca-Timestamp | string | 是 | API 调用者传递时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟,为了防重放攻击 |
Accept | string | 是 | 建议统一填写 */* |
X-Tsign-Open-Ca-Signature | string | 是 | 签名字符串 |
Content-MD5 | string | 否 | 当请求 Body 非 Form 表单时,可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时,加上此请求头。 |
X-Tsign-Open-Auth-Mode | string | 是 | 选择请求方式进行鉴权,固定值,Signature |
方式二:OAuth2.0鉴权(不推荐使用)
当安全接入选择OAuth2.0鉴权方式,请点击查阅详情。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 |
image | string | 是 | body | 机动车登记证书图片BASE64字符串 注意不要带图片BASE64前缀“data:image/jpeg;base64,” 图片类型支持:jpg,jpeg,png,bmp 图片建议分辨率1024*768,图片大小控制在1M以内 |
requestId | string | 否 | body | 请求id,标识一次客户的请求,允许为空,一般使用客户的业务id |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | ||
code | int | 是 | 接口响应结果码 | ||
message | string | 否 | 接口响应结果描述 | ||
data | object | 否 | 接口响应结果数据 | ||
verifyId | string | 否 | 业务Id | ||
registrationSummary | array | 否 | 注册登记摘要信息栏 | ||
vehicleOwnerInfo | string | 否 | 机动车所有人/身份证名称/号码 | ||
registrationAuthority | string | 否 | 登记机关 | ||
registrationDate | string | 否 | 登记日期 | ||
registrationNumber | string | 否 | 机动车登记编号 | ||
transferRegistNumber | int | 否 | 转移登记次数(转移登记摘要信息栏中的记录条数) | ||
vehicleType | string | 否 | 车辆类型 | ||
vehicleBrand | string | 否 | 车辆品牌 | ||
vehicleModel | string | 否 | 车辆型号 | ||
vehicleColor | string | 否 | 车身颜色 | ||
vinCode | string | 否 | 车辆识别代号/车架号 | ||
isDomestic | string | 否 | 国产/进口 | ||
engineNumber | string | 否 | 发动机号 | ||
engineType | string | 否 | 发动机型号 | ||
fuelType | string | 否 | 燃油种类 | ||
manufactureName | string | 否 | 制造厂名称 | ||
steeringForm | string | 否 | 转向形式 | ||
rearWheelTrack | string | 否 | 轮距 | ||
tireNumber | string | 否 | 轮胎数 | ||
frontWheelTrack | string | 否 | 总质量 | ||
permittedWeight | string | 否 | 核定载质量 | ||
passengerCapacity | string | 否 | 核定载客 | ||
tractionWeight | string | 否 | 准牵引总质量 | ||
cabPassengerCapacity | string | 否 | 驾驶室载客 | ||
useNature | string | 否 | 使用性质 | ||
acquisitionMethod | string | 否 | 车辆获得方式 | ||
manufactureDate | string | 否 | 车辆出厂日期 | ||
issueAuthority | string | 否 | 发证机关 | ||
issueDate | string | 否 | 发证日期 | ||
mortgageRegistration | array | 否 | 抵押登记 | ||
mortgageName | string | 否 | 抵押登记:抵押权人姓名/名称 | ||
mortgageIDCard | string | 否 | 抵押登记:身份证名称/号码 | ||
mortgageDate | string | 否 | 抵押登记:抵押登记日期 | ||
mortgageLiftDate | string | 否 | 抵押登记:抵押解除日期 | ||
transferRegistration | array | 否 | 转让登记,存在于登记栏的转让登记 | ||
transferName | string | 否 | 转让登记:转让人姓名/名称 | ||
transferIDCard | string | 否 | 转让登记:转让身份证名称/号码 | ||
transferWay | string | 否 | 转让登记:获得方式 | ||
transferVehicleOffice | string | 否 | 转让登记:转入地车辆管理所名称 | ||
transferNumber | string | 否 | 转让登记:机动车登记编号 | ||
transferDate | string | 否 | 转让登记:转让登记日期 |
请求示例
{
"requestId":"123456",
"image": "/9j/4AAQSkZJRgABAQEAS......"
}
响应示例
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "e44aaeb1-e7a3-4138-a62e-5825831a884e",
"registrationSummary": [
{
"vehicleOwnerInfo": "杭州天谷信息科技有限公司/统一社会信用代码/913301087458306077",
"registrationAuthority": "XXX公安局交通警察支队",
"registrationDate": "2018-04-16",
"registrationNumber": "浙A12345"
}
],
"transferRegistNumber": 0,
"vehicleType": "重型厢式贷车",
"vehicleBrand": "日野牌",
"vehicleModel": "YC5000XXYFH8JW5",
"vehicleColor": "白",
"vinCode": "LYC1CG000H0000000",
"isDomestic": "国产",
"engineNumber": "P11818",
"engineType": "J08E-WY",
"fuelType": "柴油",
"manufactureName": "广汽日野汽车有限公司",
"steeringForm": "方向盘",
"rearWheelTrack": "前后20751855mm",
"tireNumber": "6",
"frontWheelTrack": "18000kg",
"permittedWeight": "8670kg",
"passengerCapacity": "人",
"tractionWeight": "kg",
"cabPassengerCapacity": "4人",
"useNature": "货运",
"acquisitionMethod": "购买",
"manufactureDate": "2018-03-26",
"issueAuthority": "营业市公安局交通警察支队",
"issueDate": "2018-04-16",
"mortgageRegistration": [],
"transferRegistration": []
}
}
错误码
错误码 | 错误描述 | 解决方案 |
30500100 | 缺少参数:image不能为空 | image-图片BASE64字符串需要传入 |
30500101 | 参数错误:文件大小超出限制,最大1MB | 请检查传入的图片大小,需要小于1MB |