银行卡识别
接口描述
支持对主流银行卡的卡号、有效期、发卡行、卡片类型、持卡人5个关键字段进行结构化识别。
目前只支持单个银行卡识别。
请求地址
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
Timestamp | String | 必选 | 公共参数。 |
SecretId | String | 必选 | 公共参数。 |
Signature | String | 必选 | 公共参数。 |
Algorithm | String | 可选 | 公共参数。 |
Content-Type | String | 必选 | 取值：multipart/form-data |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
imageUrl | String | 可选 | 图片的 Url 地址。 支持的文件格式：PNG、JPG、JPEG。 图片大小：所下载文件经过 Base64 编码后不超过 8M，文件下载时间不超过 3 秒。 |
imageData | String | 可选 | 图片的 Base64 值。 支持的文件格式：PNG、JPG、JPEG。 图片大小：所下载文件经过 Base64 编码后不超过 8M。 |
fileData | File | 可选 | 图片、PDF、OFD 格式文件。 图片支持的格式为：PNG、JPG、JPEG。 文件大小不超过 8M。 |
fileByte | byte[] | 可选 | 图片、PDF、OFD 二进制。 文件大小不超过 8M。 |
fileName | String | 可选 | 如果参数使用 fileByte 则该参数为必选。 |
tip
注意： 输入参数 imageUrl、imageData、fileData、fileByte 必须提供一个。
返回参数
公共返回结构
| 参数名称 | 类型 | 说明 |
|---|---|---|
code | Integer | 200 表示请求成功，其他参见错误码 |
message | String | 错误提示信息 |
startTime | long | 开始时间 |
endTime | long | 结束时间 |
callId | long | 调用记录主键 |
data | Object | 识别结果 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|---|---|
startTime | long | 请求开始毫秒 |
endTime | long | 请求结束毫秒 |
bankCardList | [] | 具体的银行卡信息数组,具体参见银行卡 |
银行卡
| 参数名称 | 类型 | 说明 |
|---|---|---|
cardNumber | String | 银行卡卡号 |
effectiveDate | String | 有效期 |
bankName | String | 银行名，不能识别时为空 |
name | String | 持卡人姓名，不能识别时为空 |
cardType | 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套餐 |