查询机构授权信息

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

接口描述

通过指定企业账号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://esignapi.bestcert.net/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
            }
        ]
    }
}

错误码
点击查看错误码