银行卡信息OCR识别

目录

前言

接口文档

1. 描述

2. 图片要求

3. 调用URL

4. 调用方法

5. 请求体格式

6. 请求参数

7. 返回值说明

8. bank_cards 数组中单个元素的结构

9. 返回值示例

10. 当前API特有错误ERROR_MESSAGE

11. 通用的ERROR_MESSAGE

---

前言

目前第三方各大API市场均有提供银行卡信息OCR数据接口，聚合数据0.08元/次，阿里云0.083元/次。博主提供的数据接口调用价格0.02元/次，量大更优惠，识别准确率高达99.9%。为防止恶意调用，如需使用，请添加博主QQ(943402659)，博主需后台开通调用权限。

接口文档

1. 描述

检测和识别各类银行卡，并返回银行卡卡片边框坐标、银行卡号码、所属银行及支持的金融组织服务。支持任意角度的识别。

2. 图片要求

图片格式：JPG(JPEG)，PNG

图片文件大小：2 MB

卡片像素尺寸：最小 100*100 像素，最大 4096*4096 像素，短边不得低于 100 像素。

3. 调用URL

www.biyeyuan.org.cn:8099/api/certificate/v1/getOcrBankCard

4. 调用方法

POST

5. 请求体格式

multipart/form-data

6. 请求参数

参数名称	是否必选	类型	说明
api_key	必选	String	调用此 API 的 API Key
image_url	必选（三选一）	String	图片的 URL 注：在下载图片时可能由于网络等原因导致下载图片时间过长，建议使用 image_file 或 image_base64 参数直接上传图片。
image_file		File	一个图片，二进制文件，需要用 post multipart/form-data 的方式上传。
image_base64		String	base64编码的二进制图片数据 注：如果同时传入了image_url、image_file 和 image_base64 参数，本 API 使用顺序为 image_file优先，image_url 最低。

7. 返回值说明

字段	类型	说明
request_id	String	用于区分每一次请求的唯一的字符串。
bank_cards	Array	检测出证件的数组 注：如果没有检测出证件则为空数组
image_id	String	被检测的图片在系统中的标识
time_used	Int	整个请求所花费的时间，单位为毫秒。
error_message	String	当请求失败时才会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在。

8. bank_cards 数组中单个元素的结构

字段	类型	说明
bound	Object	银行卡卡片四个角的像素点坐标，包含以下属性： right_top：银行卡右上角的像素点坐标 left_top：银行卡左上角的像素点坐标 right_bottom：银行卡右下角的像素点坐标 left_bottom：银行卡左下角的像素点坐标 每个属性都包含以下字段。  x：像素点横坐标位置 y：像素点纵坐标位置
number	String	银行卡号。返回值为纯数字，无空格。 注：返回值的位数不做合法性校验，只会返回识别到的数字。
bank	String	表示所属的银行，内容为银行的名字； 如果没有识别到，则返回“null”
organization	Array	表示所支持的金融组织服务； 如果没有识别到列表内的组织，则返回[]； 目前会返回的组织内容如下："union"、"master"、"visa"、"jcb"

9. 返回值示例

{
    "image_id": "NTyDKpmLM7RklVcRyv2xPA==", 
    "request_id": "1524647092,eeee87f7-6c0f-4754-b108-afe8f42abe17", 
    "time_used": 427, 
    "bank_cards": [
        {
            "organization": [
                "union"
            ], 
            "number": "6217000130008255555", 
            "bank": "建设银行", 
            "bound": {
                "left_bottom": {
                    "y": 354, 
                    "x": 113
                }, 
                "right_top": {
                    "y": 90, 
                    "x": 497
                }, 
                "right_bottom": {
                    "y": 337, 
                    "x": 508
                }, 
                "left_top": {
                    "y": 106, 
                    "x": 103
                }
            }
        }
    ]
}

10. 当前API特有错误ERROR_MESSAGE

错误码	说明
400	参数<param>对应的图像无法正确解析，有可能不是一个图像文件、或有数据破损。
400	客户上传的图像太大。具体是指图像像素尺寸的长或宽超过4096像素。<param>对应图像太大的那个参数的名称
400	无法从指定的image_url下载图片，图片URL错误或者无效
412	下载图片超时

11. 通用的ERROR_MESSAGE

错误码	说明
403	api_key非法
403	api_key被停用、调用次数超限、没有调用此API的权限，或者没有以当前方式调用此API的权限。 目前的<reason>有： Denied. （没有权限调用当前API）
403	并发数超过限制。 注：这里的并发控制数超出限制，是指该API Key的QPS已经达到上限。如需要提高API Key的QPS配额请查看价格方案或者联系我们。
400	缺少某个必选参数。
400	某个参数解析出错（比如必须是数字，但是输入的是非数字字符串; 或者长度过长，etc.）
400	同时传入了要求是二选一或多选一的参数。如有特殊说明则不返回此错误。
413	客户发送的请求大小超过了2MB限制。该错误的返回格式为纯文本，不是json格式。
404	所调用的API不存在。
500	服务器内部错误，当此类错误发生时请再次请求，如果持续出现此类错误，请及时联系技术支持团队。