接口描述
当发起企业授权书签署任务后，平台可以根据授权ID查询授权的具体状态。
接口名称
AuthService.queryAuth(String authId)
请求参数
参数名称 | 类型 | 必选 | 参数说明 |
authId | String | 是 | 授权流程ID |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
authInfoResult | AuthInfoResult | 是 | 响应结果类 | |
errCode | int | 是 | 错误码，0标识成功，其他均标识失败 | |
msg | String | 否 | 错误信息，错误码对应的说明信息 | |
errorShow | boolean | 否 | 错误信息是否建议显示 | |
authId | String | 否 | 授权流程ID | |
authorizerType | int | 否 | 授权方类型 1 - 企业授权 2 - 法定代表人授权 | |
organizeId | String | 否 | 授权方企业账号ID | |
legalRepId | String | 否 | 法定代表人账号ID（法定代表人授权书签署后自动创建） 注：authorizerType=2（法定代表人授权）时会返回 | |
authType | int | 否 | 授权模式，默认为 1（授权至平台） 1 - 授权至平台 2 - 授权至经办人 | |
personId | String | 否 | 授权方经办人个人账号ID 注：authType=2（授权至经办人）时会返回 | |
authDownloadUrl | String | 否 | 授权书下载链接（有效期为60分钟，过期后可以重新调用接口获取新的下载地址） | |
status | int | 否 | 授权状态 1 - 进行中 2 - 授权成功 3 - 授权失败 4 - 取消授权 | |
authDes | String | 否 | 授权说明（授权失败时返回原因） | |
beginDate | long | 否 | 授权生效时间（Unix时间戳格式，单位：毫秒） | |
endDate | long | 否 | 授权失效时间（Unix时间戳格式，单位：毫秒） | |
请求示例
// 获取客户端的代码：
ServiceClient getKHD = ServiceClientManager.get(ConfigConstant.PROJECT_ID);
/** 查询授权结果 */
String authId = "175195111125122050";
AuthInfoResult authInfoResult = getKHD.authService().queryAuth(authId);
if (authInfoResult.getErrCode() != 0)
System.out.println("查询授权结果失败：" + JSONObject.fromObject(authInfoResult));
else
System.out.println("查询授权结果成功," + JSONObject.fromObject(authInfoResult));
响应示例
{
"msg": "成功",
"organizeId": "CE6E87D111114C81A786CF615E63BFD9",
"endDate": 1777046399000,
"errShow": false,
"authId": "38713871111157525071",
"legalRepId": "053E58C1AC411116E8B26896FA77CFD0C",
"beginDate": 1745424000000,
"errCode": 0,
"personId": "37655E43BDB1111829A9C20C4559B689E",
"authDownloadUrl": "https://esignoss.esign.cn/7438850755/7757c875-ff33-4c1e-8b1c-cca3d2590ee2/%E7%94%B5%E5%AD%90%E7%AD%BE%E7%AB%A0%E7%94%B3%E8%AF%B7%E5%8F%8A%E8%B0%83%E7%94%A8%E6%8E%88%E6%9D%83%E5%87%BD.pdf?Expires=1745492345&OSSAccessKeyId=LTAI4G23YViiKnxTC28ygQzF&Signature=LA84fPwyRGRTxXi%2FQZxCrMxMjy8%3D",
"authType": 2,
"authorizerType": 2,
"status": 2
}
我要纠错