---
order: 7
navTitle: 绑定邮箱
---
# 绑定邮箱

用于用户申请绑定邮箱，在接收到邮件验证码之后，进行绑定邮箱操作时调用。

调用此接口的时候，需要有用户登录。

## 调用说明

请求方式：`POST`\
请求url：`/api/me/bindEmail`\
请求参数示例：

```json
{
    "email": "13112345678",
    "code": "123646"
}
```

参数说明：

| 参数  | 必须 | 说明       |
| :---- | :--- | :--------- |
| email | 是   | 邮箱       |
| code  | 是   | 验证码 |

返回值示例：

```json
{
    "result": false,
    "errorCode": "emailNotFound",
    "message": "没有传递 `email` 参数"
}
```

参数说明：

| 参数      | 说明                     |
| :-------- | :----------------------- |
| result    | 校验结果，`true`标识成功 |
| errorCode | 错误编码                 |
| message   | 错误文本提示             |

`errorCode`说明

| errorCode    | 说明                                                             |
| :----------- | :--------------------------------------------------------------- |
| codeNotFound | 系统没有向邮箱发送验证码                                         |
| codeMismatch | 验证码错误                                                       |
| codeExpired  | 验证码过期了，需要重新获取                                       |
| locked       | 验证码错误次数过多，邮箱被锁定了，暂时不能使用该邮箱进行验证   |
| duplicateKey | 一个邮箱无法同时绑定多个账号，原因：用户表针对邮箱设置了唯一约束 |
