查询对内部成员授权详情

更新时间:2024-09-24 11:44:55

必须确保企业用户已授予平台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

【注】账号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://esignapi.bestcert.net/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
                }
            }
        ]
    }
}

错误码

点击查看错误码