查询对内部成员授权详情

必须确保企业用户已授予平台appId获取其印章资源管理的权限，点击查看如何授权

manage_org_seal - 授权允许获取企业/组织用户的印章的查询、新增、编辑、授权、删除权限

接口描述

查询企业内部的印章授权相关信息。

注意事项：

允许指定企业印章（sealId）查询，查询拥有该印章权限的内部成员等信息；
允许指定企业成员（authorizedPsnId）查询，查询该成员所拥有的所有印章权限；
当企业印章和企业成员均不指定时，则默认查询企业下所有的印章授权记录；

【注】默认查询通过API接口发起的印章授权记录。

接口地址&请求方法

接口地址：https://{host}/v3/seals/org-seals/internal-auth?orgId=xx&pageNum=1&pageSize=20&sealId=xx

请求方法：GET

请求头格式

具体请求头参数，请查看公共请求头格式。

请求参数

参数名称	参数类型	必选	参数位置	参数说明
orgId	string	是	query	机构账号ID 【注】用户在e签宝注册实名后才有账号ID，账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询
sealId	string	否	query	印章ID（印章编号），【注】不传则默认查询全部企业印章。
authorizedPsnId	string	否	query	被授权成员账号ID，【注】不传则默认查询全部企业成员。
pageNum	int32	是	query	查询页码
pageSize	int32	是	query	每页显示的数量，最大值：20

响应参数

展开全部参数参数名称					参数类型	必选	参数说明
code					int32	是	业务码，0表示成功，非0表示异常。
message					string	否	业务信息请根据 code 来判断错误情况，不应该依赖message匹配，因为 message 可能会调整。
data（点击“+”展开详情）					object	否	业务数据
	total				int32	否	印章授权记录条数
	sealAuthorizedInfos（点击“+”展开详情）				array	否	印章授权信息
	sealId			string	否	印章ID（印章编号）
	sealAuthBizId			string	否	授权业务流程编号
	authorizerPsnId			string	否	授权操作人账号ID
	authorizedPsnId			string	否	被授权成员账号ID
	sealRole			string	否	对应印章角色 SEAL_EXAMINER - 印章审批员，SEAL_USER - 印章使用员
	authorizeStatus			int32	否	授权状态 0 - 失效，1 - 正常，3 - 待生效
	statusDescription			string	否	授权状态描述
	expireReason			string	否	过期原因
	expireReasonDescription			string	否	过期原因描述
	effectiveTime			int64	否	授权生效时间，Unix时间戳格式，单位毫秒。
	expireTime			int64	否	授权失效时间，Unix时间戳格式，单位毫秒。
	signFlowId			string	否	授权书签署流程ID
	sealAuthScope			object	否	印章授权范围
	template		object	否	授权模板信息
		templateId	string	否	指定的模板编号或ALL
autoSign		boolean	否	印章是否设置自动落章

请求示例

GET https://openapi.esign.cn/v3/seals/org-seals/internal-auth?orgId=xxx&pageNum=1&pageSize=20&sealId=xxx

响应示例

{
    "message": "成功",
    "code": 0,
    "data": {
        "total": 4,
        "sealAuthorizedInfos": [
            {
                "sealId": "f3a5504f-3b97-***-b55a-0318f8594010",
                "authorizerPsnId": "7ffcaed8c******8f0ef0a8f6",
                "authorizeStatus": 1,
                "statusDescription": "正常",
                "effectiveTime": 1670169600000,
                "expireTime": 1701791999000,
                "expireReason": "NOT_EXPIRE",
                "expireReasonDescription": "未失效",
                "signFlowId": "39e658ba******a747fe3",
                "sealAuthBizId": "afa8abe9-5f85-****-9694-ab6d61953a8d",
                "sealRole": "SEAL_USER",
                "authorizedPsnId": "ALL",
                "sealAuthScope": {
                    "template": {
                        "templateId": "dc4dd******8b4dcf0c301b"
                    },
                    "autoSign": true
                }
            },
            {
                "sealId": "f3a5504f-3b97-****-b55a-0318f8594010",
                "authorizerPsnId": "7ffcaed******8f0ef0a8f6",
                "authorizeStatus": 1,
                "statusDescription": "正常",
                "effectiveTime": 1670169600000,
                "expireTime": 1701791999000,
                "expireReason": "NOT_EXPIRE",
                "expireReasonDescription": "未失效",
                "signFlowId": "2575fb920******8e3e8d624",
                "sealAuthBizId": "b6efe5e4-****-4ec2-915e-15d92d0d95ba",
                "sealRole": "SEAL_USER",
                "authorizedPsnId": "ALL",
                "sealAuthScope": {
                    "template": {
                        "templateId": "c73a84b28*****e2bfa312ed"
                    },
                    "autoSign": true
                }
            },
            {
                "sealId": "f3a5504f-3b97-4176-****-0318f8594010",
                "authorizerPsnId": "7ffcaed8c1b1******0a8f6",
                "authorizeStatus": 0,
                "statusDescription": "失效",
                "effectiveTime": 1670169600000,
                "expireTime": 1701791999000,
                "expireReason": "NOT_SIGN",
                "expireReasonDescription": "保存授权成功，但未进行签署授权",
                "signFlowId": "78a00b0******3c99",
                "sealAuthBizId": "d68bb620-5bb2-****-8201-570d5f131a9c",
                "sealRole": "SEAL_USER",
                "authorizedPsnId": "0e04b42******57c21e96",
                "sealAuthScope": {
                    "template": {
                        "templateId": "ALL"
                    },
                    "autoSign": false
                }
            },
            {
                "sealId": "f3a5504f-3b97-***-b55a-0318f8594010",
                "authorizerPsnId": "7ffcae*******f0ef0a8f6",
                "authorizeStatus": 0,
                "statusDescription": "失效",
                "effectiveTime": 1670169600000,
                "expireTime": 1701791999000,
                "expireReason": "NOT_SIGN",
                "expireReasonDescription": "保存授权成功，但未进行签署授权",
                "signFlowId": "78a00b******68b3c99",
                "sealAuthBizId": "ad9daef1-7bbe-****-9c97-e11669637b0d",
                "sealRole": "SEAL_USER",
                "authorizedPsnId": "626629*******4299f1d8c1d",
                "sealAuthScope": {
                    "template": {
                        "templateId": "ALL"
                    },
                    "autoSign": false
                }
            }
        ]
    }
}

错误码

点击查看错误码

印章服务API

查询对内部成员授权详情

接口描述

接口地址&请求方法

请求头格式

请求参数

响应参数

请求示例

响应示例

错误码