接口描述
查询个人用户的授权信息以及授权有效期限。
注意事项：
- 个人授权场景：用于查询个人用户授权开发者应用（AppId）的范围，以及授权有效期限；
- 企业授权场景：用于查询企业经办人授权开发者应用（AppId）的范围，以及授权有效期限；
接口地址&请求方法
接口地址：https://{host}/v3/persons/{psnId}/authorized-info
请求方法：GET
请求头格式
具体请求头参数，请查看公共请求头格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 |
psnId | string | 是 | path | 个人账号ID（或企业经办人账号ID） |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||
code | int32 | 是 | 业务码， 0表示成功，非0表示异常。 | ||
message | string | 否 | 业务信息 请根据 code 来判断错误情况，不应该依赖 message 匹配，因为 message 可能会调整。 | ||
data（点击“+”展开详情） | object | 否 | 业务数据 | ||
authorizedInfo | array | 否 | 用户授权信息 | ||
authorizedScope | string | 否 | 用户授权范围 get_psn_identity_info - 授权允许获取个人用户的账号基本信息 psn_initiate_sign - 授权允许代表个人用户发起合同签署 manage_psn_resource - 授权允许获取个人用户的印章等资源的管理权限 | ||
effectiveTime | int64 | 否 | 授权生效时间（Unix时间戳格式，单位毫秒） | ||
expireTime | int64 | 否 | 授权到期时间（Unix时间戳格式，单位毫秒） | ||
请求示例
GET https://openapi.esign.cn/v3/persons/c7e0029472***ea310541e7/authorized-info响应示例
{
"code": 0,
"message": "成功",
"data": {
"authorizedInfo": [
{
"authorizedScope": "manage_psn_resource",
"effectiveTime": 1658144081996,
"expireTime": 1660736081996
},
{
"authorizedScope": "psn_initiate_sign",
"effectiveTime": 1658144081996,
"expireTime": 1660736081996
},
{
"authorizedScope": "get_psn_identity_info",
"effectiveTime": 1658144081996,
"expireTime": 1660736081996
}
]
}
}错误码
点击查看错误码
我要纠错