车辆合格证识别API开发文档 - 北京朝阳国贸其他商务服务

一、接口简介
1、版权说明：
未经翔云人工智能开放平台授权，不得擅自进行使用。
2、调用客户端运行环境
当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。
3、服务主要功能描述：可识别车辆合格证中文字信息，包括编号、车辆品牌、车架号、底盘型号、发动机型号、发动机号、燃料种类、功率、排放标准、货厢内部尺寸、轮胎数、轴数的信息。
1) 通过https协议post方法上传各种车辆合格证图像文件，通过https接口进行识别；
2) 将识别结果以XML或json格式返回给用户；
4、服务调用约束
在调用车辆合格证识别接口前，请您确保客户端程序或设备网络连接通畅，要求图像文件大小在200KB左右，扫描图像建议分辨率为300DPI，图像小于3M。
二、前提准备
1、用户登录 https://ww***oc***/register.html注册，如图:
2、输入注册信息，确认无误后点击同意条款并注册，如图:

3、注册成功后点击右上角的名称-个人中心，进入管理页面:

4、点击“用户管理-基础信息”，查看OCRKey以及OCRSecret：

5、点击“服务列表”，查看服务次数及余额(每调用一次https接口消耗一次)，可点击立即购买直接跳转到购买页面购买API服务次数：

6、购买成功后,会显示购买的总次数及剩余次数，例如下图所示：

7、设置剩余条数提醒，进入个人中心-用户管理-剩余条数提醒，设置提醒下线、通知手机号及服务类型，设置成功后到达用户设置的服务剩余条数下限，系统会发短息至预留手机号。

三、接口说明
接口地址，图片为base64流：https://netoc***/api/recog_carhgz.do
图片为file格式：https://netoc***/api/recog_carhgz_stream.do
（注：调用图片为base64流接口时传参数img，调用图片为file格式接口传参数file）
接口调用方法：post

3、请求参数
名称类型必填说明
file MultipartFile 是上传的文件(上传文件的字段名必须是“file”)
img String 是上传的文件(图片的base64流)
key String 是用户ocrKey
secret String 是用户ocrSecrert
typeId Integer 是识别类型：42
format String 是返回格式(xml或者json)，如果format为空，则默认返回xml
识别结果字符串
<status/>标签显示了识别状态，大于等于“0”代表识别成功【“0”代表查询成功，“1”代表未查到数据，“2”代表查询失败】，小于“0”代表识别失败，失败的原因在<value/>中描述。
调用错误码
status值描述
-1 用户已屏蔽
-2 用户key或secret验证错误
-3 服务次数不足
-4 用户未找到
-6 系统异常
-7 图片不可为空，参数不可为空
-8 类型错误
识别错误码1
status值描述
-1 识别失败
调用方式(java客户端基于httpclient4.3)
1.依赖库: \java客户端\httpClient4.3库\，如图:

2.示例程序代码详见: \java客户端\httpClientDemo\中的Client类，如图:

在main方法定义参数，并传入 doPost(url, file, key, secret, typeId, format) 方法中。如图:

识别结果如下：
{
"message": {
"status": 2,
"value": "识别完成"
},
"cardsinfo": [
{
"type": "42",
"items": [
{
"nID": null,
"index": null,
"desc": "合格证编号",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "发证日期",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "车辆制造企业名称",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "车辆品牌/车辆名称",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "车辆型号",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "车辆识别代码/车架号",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "车身颜色",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "底盘型号/底盘ID",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "底盘合格证编号",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "发动机型号",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "发动机号",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "燃料种类",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "排量和功率(ml/kW)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "排放标准",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "油耗",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "外廓尺寸(mm)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "货厢内部尺寸(mm)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "钢板弹簧片数(片)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "轮胎数",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "轮胎规格",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "轮距(前/后)(mm)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "轴距",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "轴荷(kg)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "轴数",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "转向形式",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "总质量(kg)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "整备质量(kg)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "额定载质量(kg)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "载质量利用系数",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "准牵引总质量(kg)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "半挂车鞍座大允许总质量(kg)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "驾驶室准乘人数(人)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "额定载客(人)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "高设计车速(km/h)",
"content": ""
},
{
"nID": null,
"index": null,
"desc": "车辆制造日期",
"content": ""
}
]
}

剩余条数查询接口(所有产品类型)
接口地址： https://netoc***/api/accountLift.do
接口调用方法： post
接口接收参数：
String key：用户ocrKey
String secret：用户ocrSecret
String format：返回格式(xml或者json)，如果format为空，则默认返回xml
技术支持
电话： 010－87422432/2430 杨工/田工/李工