import com.chinaums.open.api.OpenApiCache;
import com.chinaums.open.api.OpenApiContext;
import com.chinaums.open.api.constants.ConfigBean;
import com.chinaums.open.api.internal.util.http.HttpTransport;
import java.util.UUID;
public class OpenApiSdkTest {
public static void main(String[] args) throws Exception{
String url = "v1/datacenter/ocr/identify +";
//开发者ID
String appId = "平台分配";
//开发者秘钥
String appKey = "平台分配";
//实例化客户端
ConfigBean configBean = new ConfigBean();
OpenApiContext context = new OpenApiContext();
String request = "{\"data\":\"{\"photoCodeOfBase64\":\"\",\"photoType\":\"\",\"rotateState\":\"\"}\"}";
context.setStartTime(System.currentTimeMillis());
context.setRequestId(UUID.randomUUID().toString().replace("-", ""));
context.setOpenServUrl(url.split("/v")[0].concat("/"));
context.setApiServiceUrl(url);
context.setVersion(url.split("/")[3]);
context.setAppId(appId);
context.setAppKey(appKey);
context.setConfigBean(configBean);
context.setServiceCode(url.split("/v")[1].substring(1));
OpenApiCache.getCurrentToken(context);
System.out.println(HttpTransport.getInstance().doPost(context, request));
}
}
<?php
require_once "../utils/Log.php";
require_once "../utils/Tools.php";
require_once "../DefaultOpenApiClient.php";
class DataRequest
{
public $url = "";
public $serviceCode = "";
public $apiVersion ="";
public $needToken = true;
public $needDataTag = false;
public $data;
function __construct($data, $url)
{
$this->data = $data;
$apiVersion = preg_split("/[/]+/s",$url)[2];
$this->apiVersion = $apiVersion;
$serviceCode = strstr($url,$apiVersion);
$this->url = strstr($url,"/".$apiVersion,true);
$this->serviceCode = preg_replace("/^" . preg_quote($apiVersion, "/") . "/", "", $serviceCode);
}
}
class DataDemo{
public function main(){
$appid = "平台分配";
$appkey = "平台分配";
$url = "v1/datacenter/ocr/identify +";
$data = json_encode(array("data"=>"{"photoCodeOfBase64"=>"","photoType"=>"","rotateState"=>""}"));
$reqiest = new DataRequest($data,$url);
$client = new DefaultOpenApiClient();
$content = $client->execute($reqiest,$appid,$appkey);
$obj = json_decode($content);
print_r($obj->errCode);
print_r($obj->errInfo);
}
}
$p = new DataDemo();
$p->main();
?>
# -*- coding: utf-8 -*-
from webapi.DefaultOpenApiClient import DefaultOpenApiClient
url = "v1/datacenter/ocr/identify +"
class DataRequest(object):
def __init__(self, data: dict) -> dict:
self.data = data
self.serviceCode = url[len(url.split("/v")[0])+len(url.split("/")[3])+1: len(url)]
self.apiVersion = url.split("/")[3]
self.needToken = True
self.needDataTag = True
appId="平台分配"
appKey="平台分配"
client = DefaultOpenApiClient(appId, appKey)
cls = DataRequest({\"data\":\"{\"photoCodeOfBase64\":\"\",\"photoType\":\"\",\"rotateState\":\"\"}\"})
response = client.execute(cls)
print(str(response.get("data")))
print(response.get("errCode"))
print(response.get("errInfo"))
print(response.get("resultCode"))
print(response.get("resultInfo"))
OCR识别
URL
- 生产环境:
POST
https://api-mop.chinaums.comv1/datacenter/ocr/identify +
描述:通过接口识别身份证照片上面的信息,支持大陆居民二代身份证正反面的字段识别,也可用于识别银行卡号
ContentType:HTTP(S) + JSON
请求头
名称 | 必填 | 描述 | 示例值 |
---|---|---|---|
Authorization | 是 | 认证内容 |
请求参数
名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
data | object | 是 | 数据 | ||
photoCodeOfBase64 | string | 是 | 照片的base64编码字符串 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 | ||
photoType | string | 是 | 照片类型 idcard_front:身份证正面传固定字符串 +idcard_back:身份证背面传固定字符串 +idcard_auto:自动判别身份证正反面传值 +bankcard_auto:银行卡带卡号卡面固定字符串 | ||
rotateState | string | 是 | 是否判定身份证方向 |
响应示例
{
"errCode":"",
"errInfo":"",
"data":
{
"reJsonStr":"",
"respCode":"",
"respMsg":""
},
"resultCode":"",
"resultInfo":""
}
响应参数
名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
errCode | string | 是 | 返回码 | ||
errInfo | string | 是 | 返回码说明 | ||
data | object | 是 | 数据 | ||
reJsonStr | string | 是 | 识别结果信息-JSON格式对象 | ||
respCode | string | 是 | 验证结果 normal表示识别正常; +wrong_sides表示识别正反异常; +reversed_side表示身份证正/反面颠倒; +non_idcard表示上传的图片中不包含身份证; +blurred表示身份证模糊; +other_type_card表示其他类型证照; +over_exposure表示未检测到身份证关键字段; +over_dark表示身份证欠曝(亮度过低); +unknown表示未知状态 | ||
respMsg | string | 是 | 结果描述 | ||
resultCode | string | 是 | 返回码 | ||
resultInfo | string | 是 | 返回码说明 |