接口描述
当e签宝登录凭证（手机号/邮箱）与目前使用者的姓名、证件号不符时，可以通过该接口获取账号解绑页面，获取验证码验证通过即可解绑原有的证件信息。解绑页面样式如下（H5/PC自动适配）：
接口地址&请求方法
接口地址：https://{host}/v3/account-unbind-url
请求方法：POST
请求头格式
具体请求头参数，请查看公共请求格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 | ||
account | string | 是 | body | 用户登录凭证：手机号或邮箱 注：传入后会展示到页面上且禁止编辑 | ||
hideTopBar | boolean | 否 | body | 是否隐藏顶部通栏，默认：false（不隐藏） true - 是（隐藏） false - 否（不隐藏） | ||
redirectUrl | string | 否 | body | 账号解绑后页面重定向跳转地址 | ||
customBizNum | string | 否 | body | 自定义业务编码 注：
| ||
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||||
code | int32 | 是 | 业务码，0表示成功，非0表示异常。 | ||||
message | string | 否 | 业务信息 请根据 code 来判断错误情况，不应该依赖message匹配，因为 message 可能会调整。 | ||||
data（点击“+”展开详情） | object | 否 | 业务数据 | ||||
accountUnbindUrl | string | 否 | 账号解绑长链接（永久有效） 【注】能获取到解绑链接不代表目前一定有绑定e签宝SaaS账号。如果当前账号没有绑定证件，会在获取验证码后提示：“该账号未绑定身份信息，无需解绑”。 | ||||
accountUnbindShortUrl | string | 否 | 账号解绑短链接 （有效期30天） | ||||
请求示例
{
"account": "139XXXX0000",
"hideTopBar":false,
"redirectUrl":"https://esign.cn",
"customBizNum":"标识本次解绑任务标识001"
}响应示例
{
"code": 0,
"message": "成功",
"data": {
"accountUnbindUrl": "https://smlh5.esign.cn/usercenterFront/unbind?account=139XXXX0000&hideTopBar=false&redirectUrl=&customBizNum=&appId=7438XXXX96",
"accountUnbindShortUrl": "https://smlt.esign.cn/WiPLaaR"
}
}错误码
code 错误码 | message 错误信息 |
1563051 | account必填 |
1563052 | account格式有误 |
1563053 | customBizNum长度过长，不超过256 |
1563053 | redirectUrl长度过长，不超过256 |
我要纠错