接口说明
企业需要实名时获取法人授权给经办人认证地址
API 方法名:nuonuo.eleConShortcutSign.companyLegalAgentAuthUrl 版本: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 | 否 | 10 | 应用名称,对接时需要找运维提供 | xiaoertest |
| enterpriseNum | String | 否 | 20 | 企业税号,仅包含字母和数字,长度应为10位或15-20位 | 339901999999142 |
| applySuccessJumpUrl | String | 否 | 255 | 认证成功页面跳转地址 | http://authdev.nntest.cn/realAuthSaasWebStatic/#/result |
| applyFailJumpUrl | String | 否 | 255 | 认证失败页面跳转地址 | http://authdev.nntest.cn/realAuthSaasWebStatic/#/fail |
| signOutUrl | String | 否 | 255 | 取消认证页面跳转地址 | http://authdev.nntest.cn/realAuthSaasWebStatic/#/index |
| applyCount | String | 是 | 10 | 人脸认证次数(默认3次) | 5 |
| applyPage | String | 是 | 1 | 人脸认证完成是否显示认证结果页面:0显示(默认),1不显示 | 0 |
| companyApplyMode | String | 是 | 1 | 认证方式:1运营商三要素、2扫脸 3扫脸+运营商三要素,不传默认1运营商三要素 | 1 |
| isSynnuo | String | 是 | 1 | 是否同步诺诺(0不同步默认 1同步) | 1 |
| operatorMobile | String | 是 | 11 | 经办人手机 | 14500010001 |
| orderNo | String | 是 | 50 | 订单号,当传入历史订单号传入时,假如该订单只认证了一半,需要跳转到相应环节继续认证;如不传,当成新流程开始 | 202605219463392723680624648460925 |
| themeColor | String | 是 | 7 | 主题色(默认橙色 #F7981A)16进制 | #F7981A |
| authCallbackUrl | String | 否 | - | 认证成功通知结果接口地址,post请求参数是{"orderNo":"人脸识别接口返回的订单号","status":"认证结果:1成功2失败","changeTime":"认证时间"} | http://authdev.nntest.cn/result.do |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | H200表示成功 | H200 |
| describe | String | 否 | - | 结果描述 | 成功 |
| result | Object | 否 | - | 结果内容 | - |
| └ orderNo | String | 否 | - | 订单号 | 202605219463392723680624648460925 |
| └ webApplyPageLink | String | 否 | - | PC端访问地址 | http://authdev.nntest.cn/realAuthSaasWebStatic/#/authCertification?token=de57982af2c44528a287a7ac532967e5 |
| └ h5ApplyPageLink | String | 否 | - | H5端访问地址 | http://authdev.nntest.cn/realAuthSaasWebStatic/#/companyStep?token=de57982af2c44528a287a7ac532967e5 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.eleConShortcutSign.companyLegalAgentAuthUrl"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"orderNo\": \"202605219463392723680624648460925\",
\"applyCount\": \"5\",
\"authCallbackUrl\": \"http://authdev.nntest.cn/result.do\",
\"applyFailJumpUrl\": \"http://authdev.nntest.cn/realAuthSaasWebStatic/#/fail\",
\"applySuccessJumpUrl\": \"http://authdev.nntest.cn/realAuthSaasWebStatic/#/result\",
\"isSynnuo\": \"1\",
\"enterpriseNum\": \"339901999999142\",
\"application\": \"xiaoertest\",
\"signOutUrl\": \"http://authdev.nntest.cn/realAuthSaasWebStatic/#/index\",
\"themeColor\": \"#F7981A\",
\"applyPage\": \"0\",
\"companyApplyMode\": \"1\",
\"operatorMobile\": \"14500010001\"
}";
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);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
H200 | 成功 | H200为成功其他code码错误信息详细查看message值 |