解除印章授权

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

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

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

接口描述

解除机构印章的授权(内部成员或跨企业)。解除成功后,开发者将收到e签宝发送的【解除印章授权】回调通知。

注意事项:

支持指定印章编号或印章授权时的业务流程编号来解除授权,区别在于当印章编号sealId同时存在内部成员授权和跨企业授权时:

  • 通过印章编号解除授权,即参数deleteType设置为sealIds,则印章对应内部成员和跨企业的授权将会一并解除。
  • 若指定解除对内部成员或跨企业一方授权,则参数deleteType可设置为sealAuthBizIds,实现对单方解除授权。

接口地址&请求方法

接口地址:https://{host}/v3/seals/org-seals/auth-delete

请求方法:POST

请求头格式

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

请求参数

参数名称

参数类型

必选

参数位置

参数说明

orgId

string

body

机构账号ID(委托单位)

【注】用户在e签宝注册实名后才有账号ID,账号ID获取方式请使用【查询机构认证信息】接口通过组织机构名称/组织机构证件号进行查询

deleteType

string

body

指定解除授权的方式

sealIds - 指定印章解除授权

sealAuthBizIds - 指定授权业务流程编号解除授权

sealIds

array

body

授权印章ID(印章编号)

补充说明:

  • 当deleteType传sealIds时,该参数必传值;
  • 最多支持传入20个印章ID。

sealAuthBizIds

array

body

授权业务流程编号

补充说明:

  • 当deleteType传sealAuthBizIds时,该参数必传值;
  • 最多支持传入20个授权业务流程编号。

响应参数

参数名称

参数类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

业务信息

请根据 code 来判断错误情况,不应该依赖message匹配,因为 message 可能会调整。

data

object

业务数据

请求示例

{   
     "orgId": "0c5bd492**48bfbf",
     "deleteType":"sealIds",
     "sealIds":["02590082-xx-xx-xx-2138db4d7b73","a1ccfad7-xx-xx-xx-84c51bf3a7e4"]
} 

响应示例

{
    "message": "成功",
    "code": 0,
    "data": null
}

错误码

点击查看错误码

我要纠错