网约车行程单识别
接口描述
支持网约车行程单关键字段的识别，包括行程起止日期、上车时间、起点、终点、里程、金额等字段。目前接口支持识别 如易行地铁行程单、滴滴出行，高德打车行程单，美团打车行程单，首汽约车电子行程单，享道出行，携程用车行程单。
请求方式
POST
请求地址
https://qst.imfbp.com/apihub/api
URL 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Action | String | 是 | 操作的接口名称，本接口取值：RecognizeRideHailingItinerary。 |
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Timestamp | String | 是 | 公共参数。 |
| SecretId | String | 是 | 公共参数。 |
| Signature | String | 是 | 公共参数。 |
| Algorithm | String | 否 | 公共参数。 |
| Content-Type | String | 是 | 取值：multipart/form-data |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| imageData | String | 否 | 图片的 Base64 值。 支持的文件格式：PNG、JPG、JPEG。 图片大小：所下载文件经过 Base64 编码后不超过 8M。 |
| fileByte | byte[] | 否 | 图片、PDF、OFD 二进制。 文件大小不超过 8M。 |
| fileName | String | 否 | 如果参数使用 fileByte 则该参数为必选。 |
tip
注意： 输入参数 imageData、fileByte 必须提供一个。
返回参数
公共返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | Integer | 200 表示请求成功，其他参见错误码 |
| message | String | 错误提示信息 |
| startTime | long | 开始时间 |
| endTime | long | 结束时间 |
| callId | long | 调用记录主键 |
| data | Object | 识别结果 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|---|---|
| startTime | long | 请求开始毫秒 |
| endTime | long | 请求结束毫秒 |
| itineraryInfo | {} | 行程单识别结果 |
itineraryInfo 行程单识别结果
| 参数名称 | 类型 | 说明 |
|---|---|---|
| serviceProvider | String | 服务商 |
| startDate | String | 行程开始日期 |
| endDate | String | 行程结束日期 |
| applyDate | String | 申请日期 |
| phone | String | 手机号 |
| totalAmount | String | 合计金额 |
| itemList | [] | 行程明细 |
itemList 行程明细
| 参数名称 | 类型 | 说明 |
|---|---|---|
| carType | String | 车型 |
| startTime | String | 上车时间 |
| endTime | String | 行程结束日期 |
| city | String | 城市 |
| startPlace | String | 起点 |
| endPlace | String | 终点 |
| distance | String | 里程 |
| amount | String | 金额 |
错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
- code：错误码。
- message：错误描述信息，帮助理解和解决发生的错误。
| 错误码 | 描述 |
|---|---|
| -1 | 服务器内部错误 |
| 1 | 无效参数 |
| 2 | 调用接口次数太频繁 |
| 3 | 不支持此种请求方式 |
| 4 | 参数不能为空 |
| 5 | 超过最大上传限制 |
| 6 | 日期格式错误 |
| 7 | 文件为空！ |
| 8 | 不支持此格式的文件！ |
| 9 | 读取pdf文件失败! |
| 10 | 读取ofd文件失败! |
| 11 | JDK的IllegalAccessException |
| 12 | JDK的IllegalArgumentException |
| 13 | 读取文件失败! |
| 1000 | 非法参数 |
| 1001 | base64 decoder error |
| 1002 | 上传的文件大小错误，现阶段我们支持的文件大小为： 8M |
| 1003 | 现阶段我们支持上传单张图片! |
| 1004 | imageUrl, imageData, (fileName,fileByte |
| 1005 | 图片为空，请检查后重新尝试 |
| 1006 | OCR识别失败。 |
| 1007 | OFD文件为空！ |
| 4001 | 调用SDK权限校验不通过！ |
| 4002 | 调用接口Action不能为空！ |
| 4003 | API名称出错！ |
| 4004 | SecretId不能为空！ |
| 4005 | Timestamp不能为空！ |
| 4006 | Signature不能为空！ |
| 4007 | 用户没有调用当前API的权限！ |
| 4008 | 签名不正确 |
| 4009 | 查询用户密钥为空，请联系管理员 |
| 4010 | 无当前接口权限 |
| 4011 | Timestamp与服务器接收到请求的时间相差不得超过五分钟 |
| 4012 | apicode不能为空！ |
| 4013 | apicode未关联客户！ |
| 5001 | 不支持的请求方式 |
| 6001 | 套餐包余量不足 |
| 6002 | 未开通访问此API套餐 |