[TOC] ## 获取验证码 ~~~[api] post:/acquire *string:phone=15181474781#手机号 <<< success { "code": 0, "data": { "expire": 10, "length": 6, "captcha": "836018" } } <<< error { "code": -1, "msg": "手机号长度错误" } ~~~ ## 获取验证码 * 接口地址: `/acquire` * 请求方式: post * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `phone` | string | 11 | `是` | 手机号 | * 成功请求返回: ```json { "code": 0, "data": { "expire": 10,//验证码有效期 "length": 6,//验证码长度 "captcha": "175382"//测试返回验证码 } } ``` * 请求失败返回: ```json { "code": -1, "msg": "手机号长度错误" } ``` ## 短信登录 * 请求地址: `/loginPhone` * 请求方式: post * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `phone` | string | 11 | `是` | 手机号 | | `sms_captcha` | string | 6 | `是` | 短信验证码 | * 成功返回: ```json { "code": 0, "data": { "sessionKey": "****",//登录备用 "sessionValue": "*****",//登录备用 "name": "**",//管理姓名 "id": 1 } } ``` * 失败返回: ```json { "code": -1, "msg": "手机号长度错误" } ``` ## 密码登录 * 请求地址: `/loginPhone` * 请求方式: post * 请求参数: | 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 | | --- | --- | --- | --- | --- | | `phone` | string | 11 | `是` | 手机号 | | `password` | string | 2-200 | `是` | 密码 | * 成功返回: ```json { "code": 0, "data": { "sessionKey": "xxxxxxxxx", "sessionValue": "xxxxxxxxxxxxxxxxxx", "name": "xxx", "id":1 } } ``` * 失败返回: ```json { "code": -1, "msg": "手机号长度错误" } ``` ## 退出登录 * 请求地址: `/out` * 请求方式: post|get * 请求参数:无 * 成功返回: ```json { "code": 0 } ```