查询机构授权信息

更新时间:2024-11-20 11:14:53

接口描述

通过指定企业账号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
            }
        ]
    }
}

错误码
点击查看错误码

我要纠错