[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":"参数错误"
}
```
