接口描述
当e签宝登录凭证（手机号/邮箱）需要修改或者新增时，可以使用该接口获取用户账号绑定页面，用户需要输入新的手机号/邮箱，新旧手机号/邮箱都需要获取验证码并回填成功后方可操作成功。页面样式如下（H5/PC自动适配）：
注意：
- 当用户之前没有当前登录方式时，则视为新增，有当前登录方式时，则视为修改。例如：之前仅有手机号登录，本次获取的绑定新邮箱页面，则绑定后该用户则有原手机号和新邮箱两种登录方式。
- 当用户传入的新手机号/邮箱已被其他用户绑定时，则不能被当前用户绑定成功。
接口地址&请求方法
接口地址：https://{host}/v3/account-binding-url
请求方法：POST
请求头格式
具体请求头参数，请查看公共请求格式。
请求参数
参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 | ||
account | string | 是 | body | 用户登录凭证：手机号或邮箱 注：传入后会展示到页面上且禁止编辑 | ||
changeType | string | 否 | body | 绑定账号的新登录凭证类型，默认：mobile（手机号） mobile - 手机号 email - 邮箱 注：如果该类型的登录凭证之前已存在，则进行修改操作，如果不存在则进行新增绑定操作 | ||
hideTopBar | boolean | 否 | body | 是否隐藏顶部通栏，默认：false（不隐藏） true - 是（隐藏） false - 否（不隐藏） | ||
redirectUrl | string | 否 | body | 账号解绑后页面重定向跳转地址 | ||
customBizNum | string | 否 | body | 自定义业务编码 注：
| ||
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | ||||
code | int32 | 是 | 业务码，0表示成功，非0表示异常。 | ||||
message | string | 否 | 业务信息 请根据 code 来判断错误情况，不应该依赖message匹配，因为 message 可能会调整。 | ||||
data（点击“+”展开详情） | object | 否 | 业务数据 | ||||
accountBindUrl | string | 否 | 账号修改/新增链接（有效期7天） | ||||
请求示例
{
"customBizNum": "标识本次修改或新增任务标识001",
"account": "198XXXX2222",
"changeType": "mobile",
"hideTopBar": false,
"redirectUrl": "https://open.esign.cn/"
}
响应示例
{
"code": 0,
"message": "成功",
"data": {
"accountBindUrl": "https://smlh5.esign.cn/usercenterFront/rebind?account=198****2222&contextId=4c9760988ded4e829e3d78909af7a595&changeType=mobile&hideTopBar=false&redirectUrl=&customBizNum=%E6%A0%87%E8%AF%86%E6%9C%AC%E6%AC%A1%E6%8D%A2%E7%BB%91%E6%88%96%E6%96%B0%E5%A2%9E%E4%BB%BB%E5%8A%A1%E6%A0%87%E8%AF%86001&appId=1111028765"
}
}错误码
code 错误码 | message 错误信息 |
1563051 | account必填 |
1563052 | account格式有误 |
1563053 | customBizNum长度过长，不超过256 |
1563053 | redirectUrl长度过长，不超过256 |
我要纠错