银行卡验证
接口描述
用户通过发送HTTP Post请求方式提交数据至公有云服务器,服务器识别并返回json格式的识别结果。
接口说明
请求URL:http://api.exocr.com/data/v1/verify_bank_card
请求方式:HTTP Post
返回格式:json
API 定义
ocr/v1/temp_id
请求参数
字段 | 必选 | 类型 | 说明 |
---|---|---|---|
app_key | 是 | string | 请在控制台->我的应用中获取 |
app_secret | 是 | string | 请在控制台->我的应用中获取 |
bank_card_no | 是 | string | 银行卡卡号 |
personal_name | 是 | string | 姓名 |
identity_card_no | 是 | string | 身份证号码 |
phone_no | 否 | string | 电话号码。可选参数,需要四要素认证时传此参数,三要素认证时则不需传此参数。 |
调用示例
java(相关依赖库下载)
package com.exocr.httpclient;
import java.io.FileNotFoundException;
import java.util.HashMap;
import java.util.Map;
import com.exocr.common.utils.HttpClientUtils;
public class Test {
public static void main(String[] args) throws FileNotFoundException {
//识别url
String url = "http://api.exocr.com/data/v1/verify_bank_card";
//设置请求参数
Map<String, String> params = new HashMap<String, String>();
params.put("app_key", "#####");
params.put("app_secret", "#####");
// 三要素
params.put("bank_card_no", "##########");
params.put("personal_name", "张三");
params.put("identity_card_no", "##########");
// 四要素
// params.put("bank_card_no", "##########");
// params.put("personal_name", "张三");
// params.put("identity_card_no", "##########");
// params.put("phone_no", "######");
//发送请求,得到识别结果
String string = HttpClientUtils.doPost(url, params);
System.out.println(string);
}
}
返回示例
{
"result": {
"gender": "0",
"birthday": "1992-11-03",
"desc": "比对通过",
"result_code": 10000
},
"error_code": 0,
"description": "调用成功",
"request_id": "CE3D6D2F945242ED8FCF474855997BE6",
"recognize_time": 94,
"available_count": 80
}
返回结果
通用参数
参数 | 类型 | 说明 |
---|---|---|
result | array | 返回结果数组,包括所有字段的识别信息 |
error_code | int | 错误码,返回0为正确,其他为错误 |
description | string | 识别结果描述 |
request_id | string | |
recognize_time | int | 识别所用时间,单位为毫秒 |
available_count | int | 识别剩余可用次数,次数不足时无法继续识别,可在控制台进行充值次数 |
银行卡认证特有参数
参数 | 类型 | 说明 |
---|---|---|
desc | string | 认证结果描述 |
result_code | int | 认证结果码 |
认证结果码
结果码 | 类型 | 说明 |
---|---|---|
20000 | int | 认证一致 |
20500 | int | 认证不一致,认证未通过 |