修改印章授权期限

更新时间:2024-09-24 11:45:34

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

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

接口描述

基于原印章授权(企业内授权或跨企业)所保留的授权业务流程编号(包含已过期的流程),重新修改印章授权的有效期限。

  • 通过接口重新修改授权有效期后,授权操作人需重新签署授权书;
  • 通过接口重新修改授权有效期后,原有保留的授权业务流程编号、授权书签署链接将失效。

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

请求方法:POST

请求头格式

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

请求参数

参数名称

参数类型

必选

参数位置

参数说明

orgId

string

body

机构账号ID

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

transactorPsnId

string

body

授权操作人账号ID (指企业法定代表人或企业管理员)

sealAuthBizId

string

body

原授权业务流程编号

effectiveTime

int64

body

授权生效时间(unix时间戳格式,单位:毫秒)

expireTime

int64

body

授权失效时间(unix时间戳格式,单位:毫秒)

redirectUrl

string

body

授权书签署完成后重定向跳转地址 (需符合http、https协议,且最长不可超过1024字符)

appScheme

string

body

签署授权书时进行支付宝刷脸意愿认证后,可以跳回开发者app。

响应参数

展开全部参数参数名称

参数类型

必选

参数说明

code

int32

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

message

string

业务信息

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

data(点击“+”展开详情)

object

业务数据

newSealAuthBizId

string

新的授权业务流程编号

authorizationSignShortUrl

string

授权书签署短链接(有效期30天)

authorizationSignUrl

string

授权书签署长链接

请求示例

{
    "sealAuthBizId": "7eb81942-xx-xx-xx-b59aa2ba479f",
    "orgId": "0c5bd4924***5648bfbf",
    "transactorPsnId": "c7e002***ea310541e7",
    "effectiveTime": "1636525541000",
    "expireTime": "1668061541000",
    "redirectUrl": "http://www.xxx.cn/"
}

响应示例

{
  "message": "成功",
  "code": 0,
  "data": {
    "newSealAuthBizId": "61b9d337-xx-xx-xx-0dc308d32d3c",
    "authorizationSignUrl": "https://h5.esign.cn/mesign/guide?context=Nksbcxa&flowId=0d46****89889dce16966b8&organ=true&appId=5****5&linkSource=1&bizType=1&tsign_source_type=SIGN_LINK_XUANYUAN&tsign_source_detail=1vGqUyZBm8k4aIosgUEaAJ40lsE7AJ7F9iSLvM9qrkC28h11ZZUbSoIipVsi%2BtbjwrVJo2n0cjgeEFrWTVKT8mOocb7oM8s2EIx3JuKOt16arLi98Q0TRUjf3JROLf08nYE2XOMSuPrevLzSmwsVj1GKu4v0VKzqOOcpKoj%2BeAuhvQL6l1mXSrTXXZ0kmK5bXfbgH%2F2tW0rbfa3iyzlHvb%2FCYLKwiQ5xvOEghorX0i2eypB%2Frf",
    "authorizationSignShortUrl": "https://t.esign.cn/UmLd***EDy6"
  }
}

错误码

点击查看错误码

我要纠错