接口说明
打开人脸实名认证地址,需要通过该接口获取token。一个token只能用一次,获取之后2分钟内有效。支持H5接入、微信小程序接入、 APP SDK接入、微信小程序E证通接入等多种接入方式
API 方法名:nuonuo.eleConShortcutSign.getFaceRecognitionToken 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| application | String | 否 | - | 应用名称 | xiaoertest |
| orderNo | String | 否 | - | 人脸识别接口返回的订单号 | 2020112414073323943062412 |
| userName | String | 是 | - | 用户名,useSceneType = 2,useSceneType = 4 时必传 | 张三 |
| idNumber | String | 是 | - | 身份证,useSceneType = 2,useSceneType = 4 时必传 | 3307241111122321 |
| useSceneType | String | 是 | - | 使用场景(1APP、H5、微信公众号等 2微信小程序 3 APP SDK接入(光线+眨眼)4微信小程序E证通; 默认1) | 1 |
| merchantId | String | 是 | 50 | EID商户id,字段长度最长50位,useSceneType = 4 时必传 | 0NSJ2207221605557457 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | | H200 |
| describe | String | 否 | - | | 成功 |
| result | String | 否 | - | token | eyJhdWQiOlsiMjAyMDExMjQxNDA3MzMyMzk0MzA2MjQxMiIsIjIwMjAtMTItMDJUMjI6NDk6NDMuNjQ5Il19.fYAC1v-A3HIbrNPxj9zYRqKpZrSoaFUNUokpPu3vPQs |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.eleConShortcutSign.getFaceRecognitionToken"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"orderNo\": \"2020112414073323943062412\",
\"useSceneType\": \"1\",
\"application\": \"xiaoertest\",
\"merchantId\": \"0NSJ2207221605557457\",
\"userName\": \"张三\",
\"idNumber\": \"3307241111122321\"
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);
响应报文示例
{
"code": "H200",
"describe": "成功",
"result": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOlsiMjAyMDExMjQxNDA3MzMyMzk0MzA2MjQxMiIsIjIwMjAtMTItMDJUMjI6NDk6NDMuNjQ5Il19.fYAC1v-A3HIbrNPxj9zYRqKpZrSoaFUNUokpPu3vPQs"
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
H200 | 200 | |
H99999 | 请求异常或服务器异常 | |
H88888 | 参数异常 | |