[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": "參數錯誤!"
}
```