[TOC]
## 个人资料
* 请求地址： `/user`
* 请求方式： get
* 请求参数： 无
* 成功返回：
```json
{
"code": 0,
"data": {
"photo": null,//头像地址
"phone": "15181474781",//手机号
"nickname": null,//昵称
"sex": 1,//性别 0 女 1 男
"introduce": null,//自我介绍
"last_time": 1510365925,//上次登录时间
"email": 1//未读邮件数量
}
}
```
* 失败返回： 其他错误信息
## 修改用户个人资料
* 请求地址： `/user/update`
* 请求方式： post
* 请求参数：
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `nickname` | string | 2-16 | `是` | 昵称 |
| `sex` | int | 0,1 | `是` | 性别(0：女 1：男) |
| `photo` | string | 2-160 | 是 | 头像地址 |
| `introduce` | string | 0-255 | 是 | 个人说明 |
* 成功返回：
```json
{
"code":0
}
```
* 失败返回：
```json
{
"code":-1,
"msg":"参数错误"
}
```
## 绑定手机
* 请求地址: `/user/bind`
* 请求方法: post
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `phone` | string | 11 | `是` | 手机号 |
| `sms_captcha` | string | 6 | `是` | 短信验证码 |
* 成功返回:
*
```json
{
"code": 0
}
```
* 失败返回:
```json
{
"code": -2，
"msg": "请先绑定手机"
}
```
## 更换手机号
* 请求地址： `/user/phone`
* 请求方式： post
* 请求参数：
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `phone` | string | 11 | `是` | 手机号 |
| `sms_captcha` | string | 6 | `是` | 短信验证码 |
* 成功返回：
```json
{
"code":0
}
```
* 失败返回：
```json
{
"code":-1,
"msg":"参数错误"
}
```
## 获取文件上传地址
* 请求地址: `/user/getUpdatePath`
* 请求方式: get
* 请求参数: 无
* 成功返回:
```json
{
"oss_id": "",//ossid
"host": "",//上传地址
"policy": "",//上传需要的 参数
"signature": "",//上传需要的 参数
"expire": 0,//上传时间限制
"dir": "",//上传文件目录名
"max_size": ,//上传文件大小限制
"key": ""//上传文件的文件名
}
```
>[info] 上传参数
```json
"OSSAccessKeyId": "oss_id",
"policy": "policy",
"Signature": "signature",
"key":"key",
"success_action_status":"201",
"file":"raw file data"
```
>[info] 提交地址为返回参数中的host
>[danger] 注：上传方式 需要使用表单 `FormData` 格式上传
>注：返回的上传参数中若有key，必须使用返回的key，如果没有，就需要使用返回的 `dir+/filename` 的格式拼接文件名
>注：`filename` 是自己定义的文件名
>注： file字段**必须在最后**，类型根据平台不同而不同，兼容 `FormData`即可
>注：上传成功之后会返回一个xml格式的文件，请解析xml文件 。
>注：取出xml文件的 location 当做图片或者视频地址 提交到服务器
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
