银行卡识别
一、接口描述
1. 功能描述
基于业界领先的深度学习技术，识别银行卡号，日期，卡类型，银行名称，卡号位数等多个关键字段，准确可靠。
2. 接口使用
在获得使用权限后，您可使用已经封装好的SDK进行相应开发，整体流程详见调用方法 。
3. 图片要求
- 图片格式：jpg/jpeg、png
- 图片大小：小于5M
- 目前只支持横卡，暂不支持竖卡。
二、请求说明
1. 接口地址 ：
https://aiapi.jdcloud.com/jdai/ocr_bankcard
2. 请求方式：
https post aiapi.jdcloud.com/jdai/ocr_bankcard
3. 请求参数
（1）header请求参数
业务请求参数
| 名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| Authorization | string | 是 | JDCLOUD2-HMAC-SHA256Credential=access... | 签名 |
| Content-Type | String | 是 | application/octet-stream | 标准编码格式 |
（2）query请求参数
（3）body请求参数
| 名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| 无 | binary | 是 | 无 | 图片内容，传入图片 |
4. 请求代码示例
建议您使用我们提供的SDK进行调用，SDK获取及调用方式详见sdk的使用方法
三、返回说明
1、返回参数
（1）公共返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | string | 1000 | 参见错误码-系统级错误码 |
| charge | boolean | false 或 true | false：不扣费， true：扣费 |
| remain | long | 1305 | 按天计算剩余调用次数 |
| msg | string | 查询成功 | 参见错误码-系统级错误码 |
| result | object | {...} | 查询结果 |
（2）业务返回参数
服务器返回的识别结果采用 JSON 格式：
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | string | 0 | 参照四、错误码-业务错误码 |
| message | string | success | 状态码描述 |
| request_id | string | cb4f53b8c60e9589445cc4cd895cf5b6 | 为方便定位问题的32位uuid |
| result | json | {...} | 返回识别结果 |
result参数信息
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| bank_name | string | 邮政银行北京分行 | 银行名称 |
| bank_number | string | 6221881000046221446 | 银行卡号 |
| card_count | string | 19 | 卡号位数 |
| card_name | string | 绿卡银联标准卡 | 卡名称 |
| card_type | string | 储蓄卡 | 卡类型 |
| bank_date | string | 05/2008 | 银行卡日期 |
2、返回示例
{ "code": "10000", "charge": false, "remainTimes": 4998, "remainSeconds": -1, "msg": "查询成功", "result": { "code": 0, "message": "success", "request_id": "815774d6ed6ca43e5d0cce316d36d822", "result": { "bank_name": "邮政银行北京分行", "bank_number": "6221881000046221446", "card_count": "19", "card_name": "绿卡银联标准卡", "card_type": "储蓄卡", "bank_date": "05/2008" } } } 3、业务错误码
| 业务错误码（code） | message | 说明 |
|---|---|---|
| 12001 | "File was missing or 0 bytes" | 图片缺失或者为空 |
| 12002 | "File error" | 文件读取出错 |
| 12003 | "File format only allow: jpg(jpeg), png" | 图片格式只支持jpg(jpeg),png两种 |
| 12004 | "The file size is too large. Maximum supports 5M" | 文件太大，最多支持5M |
| 12005 | "Recognize Error" | 识别出错 |
| 12006 | "Program Error" | 程序内部错误 |
| 12007 | "Recognize empty result" | 识别结果为空 |
更新时间：2020-04-28 21:14:40
文档反馈
