必须确保企业用户已授予平台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(印章编号) 补充说明:
| |
sealAuthBizIds | array | 否 | body | 授权业务流程编号 补充说明:
|
响应参数
参数名称 | 参数类型 | 必选 | 参数说明 | ||||
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
}