接口描述
通过指定企业账号ID,来查询组织机构用户的授权范围以及授权的有效期限。
接口地址&请求方法
接口地址:https://{host}/v3/organizations/{orgId}/authorized-info
请求方法:GET
请求头格式
具体请求头参数,请查看公共请求头格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 |
orgId | string | 是 | path | 机构账号ID |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 | ||
message | string | 否 | 业务信息 请根据 code 来判断错误情况,不应该依赖 message 匹配,因为 message 可能会调整。 | ||
data(点击“+”展开详情) | object | 否 | 业务数据 | ||
authorizedInfo | array | 否 | 用户授权信息 | ||
authorizedScope | string | 否 | 用户授权范围 get_org_identity_info - 授权允许获取机构以及经办人的账号基本信息 org_initiate_sign - 授权允许代表机构用户发起合同签署 manage_org_resource - 授权允许获取机构用户的模板、印章、组织成员等资源的权限 use_org_order - 授权允许获取机构用户套餐订单的使用权限 | ||
effectiveTime | int64 | 否 | 授权生效时间(Unix时间戳格式,单位毫秒) | ||
expireTime | int64 | 否 | 授权到期时间(Unix时间戳格式,单位毫秒) |
请求示例
GET https://openapi.esign.cn/v3/organizations/0c5bd4924**8bfbf/authorized-info
响应示例
{
"code": 0,
"message": "成功",
"data": {
"authorizedInfo": [
{
"authorizedScope": "use_org_order",
"effectiveTime": 1653967422402,
"expireTime": 1656559422402
},
{
"authorizedScope": "manage_org_resource",
"effectiveTime": 1653967422402,
"expireTime": 1656559422402
},
{
"authorizedScope": "org_initiate_sign",
"effectiveTime": 1653967422402,
"expireTime": 1656559422402
},
{
"authorizedScope": "get_org_identity_info",
"effectiveTime": 1653967422402,
"expireTime": 1656559422402
}
]
}
}
错误码
点击查看错误码