查询机构授权信息

更新时间:2025-05-06 16:54:16

接口描述

通过指定企业账号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_member - 授权允许获取企业/组织用户的组织成员的查询、新增、编辑、删除权限
  • manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限
  • manage_org_template -授权允许获取企业/组织用户的模板的查询、新增、编辑、复制、删除权限
  • use_org_template - 授权允许获取企业/组织用户的模板的使用权限
  • manage_org_resource - 授权允许获取企业/组织用户的印章、组织成员等资源的管理权限(不包含用印权限)
  • org_sign_file_storage - 授权允许企业/组织合同文件存储到平台应用的本地服务器
  • org_approval_info - 授权允许获取企业/组织用户的用印审批信息
  • 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
            }
        ]
    }
}

错误码
点击查看错误码

我要纠错