查询个人授权信息

更新时间:2023-07-10 10:34:12

接口描述

查询个人用户的授权信息以及授权有效期限。

注意事项:

  • 个人授权场景:用于查询个人用户授权开发者应用(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://bestcert.net/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
}
]
}
}

错误码
点击查看错误码