银行卡识别
接口描述
支持对主流银行卡的卡号、有效期、发卡行、卡片类型、持卡人5个关键字段进行结构化识别。
目前只支持单个银行卡识别。
请求方式
POST
请求地址
https://qst.imfbp.com/apihub/api
URL 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Action | String | 是 | 操作的接口名称，本接口取值：RecognizeBankCard。 |
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套餐 |