承兑汇票OCR接口

接口描述

将电子银行承兑汇票，电子商业承兑汇票图片信息转化成标准化文字信息。

请求说明

请求地址 https://api.cwjyz.com.cn/dp/bill_ocr
请求方式 POST/GET

基本参数

参数	值
appid	请联系管理员获取。联系方式 QQ：34165854
sign	根据管理员提供的 app id　和　app secret 生成

请求参数

参数	是否必填	类型	可选值范围	说明
image	和 url 二选一	string	-	图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过6M，最短边至少15px，最长边最大8192px，支持jpg/jpeg/png/bmp格式
url	和image二选一	string	-	图片完整url，url长度不超过1024字节，url对应的图片base64编码后大小不超过6M，最短边至少15px，最长边最大8192px，支持jpg/jpeg/png/bmp格式优先级：image > url ，当image字段存在时，url字段失效

请求示例

方法1： image传参

POST https://api.cwjyz.com.cn/dp/bill_ocr

Request Header:   
Content-Type: application/json   

Request Body:
{   
    'appid': '您的APP ID',
    'sign' : '您的SIGN',
    'image': '/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKg...', /* base64 信息 */
}

方法2： url传参

POST https://api.cwjyz.com.cn/dp/bill_ocr

Request Header:   
Content-Type: application/json

Request Body:
{   
    'appid': '您的APP ID',
    'sign' : '您的SIGN',
    'url'  : 'http://www.xxx.com/1-201915101004234.png',
}

    POST https://api.cwjyz.com.cn/dp/bill_ocr
    Request Header:   
    Content-Type: application/json   
    Request Body:
    {   
           'appid': '您的APP ID',
       'sign' : '您的SIGN',
       'url'  : 'http://shangpiaoyi.cn/uploads/allimg/200915/1-200915101004234.png',
    }

返回说明

返回格式 JSON

返回字段

字段	是否必备	类型	说明
code	是	int	状态码: - 200 请求成功 - 400 请求失败
msg	是	string	提示信息
query_id	是	int	唯一的请求编号
remaining	是	int	该API接口剩余可使用次数。注：调用成功且返回数据才扣减次数
result	是	array	识别结果
+ bill_no	否	string	票据号码
+ type	否	int	1：银票 2：商票
+ issue_date	否	Data(yyyy-mm-dd)	出票日期
+ due_date	否	Data(yyyy-mm-dd)	到期日
+ payer	否	string	承兑人
+ payer_acct	否	string	承兑人银行账号
+ payer_bank	否	string	承兑人银行名称
+ payer_cnaps	否	string	承兑人银行行号
+ drawer	否	string	出票人
+ drawer_acct	否	string	出票人账号
+ drawer_bank	否	string	出票人银行名称
+ payee	否	int	收票人
+ payee_acct	否	string	收票人账号
+ payee_bank	否	string	收票人银行名称
+ amount	否	string	金额

返回示例

{
"code": 200,
"msg": "识别完成",
"query_id": "668588007304",
"remaining": 799,
"result": {
            "bill_no": "230229003110620200113562621648",
            "type": "2",
            "issue_date": "2020-01-13",
            "due_date": "2021-01-13",
            "drawer": "某某地产集团上海置业有限公司",
            "drawer_acct": "9113010182100016318",
            "drawer_cnaps": "302290031106",
            "drawer_bank": "中信银行股份有限公司上海分行营业部",
            "payee": "某某城博置业有限公司",
            "payee_acct": "209381101310601",
            "payee_bank": "招商银行股份有限公司宁波明州支行",
            "payer_cnaps": "302290031106",
            "payer": "某某地产集团上海置业有限公司",
            "payer_bank": "中信银行股份有限公司上海分行营业部",
            "payer_acct": "9113010182100016318",
            "amount": 1000000
          }
                                    
}

错误码

代码	说明
401	无效app id
403	签名sign验证错误
405	剩余可使用次数为0
400	识别失败，服务器内部错误，不扣次数
4003	上传内容不是标准图片
4004	缺少参数：image 和 url 必填其一