接口说明
企业平台调用该接口,查询局端登录二维码或短信验证码。具体流程第一步调“nst发送登录二维码/短信验证码”接口——》第二步调“nst查询登录二维码/短信验证码”—〉第三步调“nst提交扫码验证/短信验证”—》第四步调“nst查询扫码验证/短信验证结果”,验证成功后表示登录成功,可进行下一步的业务操作。
API 方法名:nuonuo.OpeMplatform.eleAccount 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| eleAccount | String | 否 | - | 全电账号 | 15700078870 |
| type | Number | 否 | - | 验证类型1-短信验证码 2-多源扫码 3-税务APP扫码 | 1 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 返回码 | E0000 |
| describe | String | 否 | - | 返回说明 | 调用成功 |
| result | Object | 否 | - | | - |
| └ verifyStatus | Number | 否 | - | 0-获取验证码/二维码中 1-获取验证码/二维码成功 2-获取验证码/二维码失败 4-提交验证成功 | 1 |
| └ verifyData | String | 否 | - | 发送短信的手机号/扫码登录的二维码字符串 | - |
| └ failMsg | String | 否 | - | 获取失败原因 | - |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.eleAccount"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"eleAccount\": \"15700078870\",
\"type\": 1
}";
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": "E0000",
"describe": "调用成功",
"result": {
"verifyStatus": "1",
"verifyData": "131****1313",
"failMsg": ""
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E0000 | 成功 | |
E9999 | 全电账号和验证类型参数不能为空 | 检查请求参数 |
E6030 | 暂时只支持全电平台 | 该地区不支持验证 |
E6039 | 暂未开启登录验证 | 该地区不支持验证 |
E6042 | 正在验证登录中,请稍后操作 | 稍后操作 |
E6045 | 税局登录成功 | 已登录不需要验证 |