[TOC]
## 獲取驗證碼
* 接口地址： `/acquire`
* 請求方式： post
* 請求參數：
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `phone` | string | 11 | `是` | 手機號 |
* 成功請求返回:
```json
{
"code": 0,
"data":
{
"expire": 10,//驗證碼有效分鐘數
"length": 6,//驗證碼長度
"captcha": "175382"//調試輸出驗證碼
}
}
```
* 請求失敗返回:
```json
{
"code": -1,
"msg": "手機號長度錯誤"
}
```
## 登錄
* 請求地址: `/login`
* 請求方式: post
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `phone` | string | 11 | `是` | 手機號 |
| `password` | string | 2-255 | `是` | 密碼 |
>[danger] 注： 密碼請加密
* 成功返回:
```json
{
"code": 0,
"data": {
"sessionKey": "******",//登錄信息備用
"sessionValue": "******",//登錄信息備用
"type": "sale",//用戶類型
"id": 1//用戶唯一id
}
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "手機號長度錯誤"
}
```
## 退出登錄
* 請求地址: `/out`
* 請求方式: post|get
* 請求參數:無
* 成功返回:
```json
{
"code": 0
}
```
* 失敗返回:其他錯誤信息
## 注冊
* 請求地址： `/register`
* 請求方式： post
* 請求參數：
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `phone` | string | 11 | `是` | 手機號 |
| `password` | string | 2-255 | `是` | 密碼 |
| `sms_captcha` | string | 6 | `是` | 短信驗證碼 |
>[danger] 注： 密碼請加密
* 成功返回：
```json
{
"code": 0
}
```
* 失敗返回：
```json
{
"code":-1,
"msg":"參數錯誤"
}
```
## 忘記密碼
* 請求地址： `/forget`
* 請求方式： post
* 請求參數：
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `phone` | string | 11 | `是` | 手機號 |
| `password` | string | 2-255 | `是` | 密碼 |
| `sms_captcha` | string | 6 | `是` | 短信驗證碼 |
`密碼請加密`
* 成功返回：
```json
{
"code":0
}
```
* 失敗返回：
```json
{
"code":-1,
"msg":"參數錯誤"
}
```
## 獲取平臺協議
* 請求地址： `/config/protocol`
* 請求方式： get
* 請求參數： 無
* 成功返回：
```json
{
"code": 0,
"data": {
"protocol": ""//平臺協議
}
}
```
* 失敗返回：
```json
{
"code":-1,
"msg":"參數錯誤"
}
```
