会员登录

接口地址：http://localhost/public/api/app.php?s=App.Auth.UserLogin

接口描述： 通过会员登录进行授权，根据会员的账号和密码进行会员登录，登录成功后分配新的访问令牌

HTTP/HTTPS
请求协议
GET/POST
请求方式
UTF-8
编码格式
JSON
返回格式

接口参数

参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明
--- | --- | --- | --- | --- | ---
username | 字符串 | 必须 | - | 最小：1；最大：50 | 账号
password | 字符串 | 必须 | - | 最小：6；最大：20 | 密码
app_key | 字符串 | 必须 | - |  | app_key，用于区分客户端应用

返回字段

返回结果 | 类型 | 说明
--- | --- | ---
ret | 整型 | 状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误
data | 对象或混合类型 | 业务数据，由各自接口指定，通常为对象
data.access_token | 字符串 | 新的访问令牌，申请失败时返回空字符串，包含登录的用户ID
data.expire_at | 整型 | 过期时间戳
msg | 字符串 | 提示信息，失败时的错误提示

在线测试

参数 | 是否必须 | 值
--- | --- | ---
service | 必须 |
username | 必须 |
password | 必须 |
app_key | 必须 |

客户端请求示例

    {
        "ret": 200,
        "data": {
            "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJwaGFsYXBpX3BybyIsImF1ZCI6InBoYWxhcGlfcHJvIiwic3ViIjoidGVzdCIsInVpZCI6NCwiaWF0IjoxNTc2NzUxNzA4LCJleHAiOjE1NzY4MzgxMDh9.Z3No7bqNfhPcOWYfMio9i8MqqUMvGVmMhkhsT782YD0",
            "expire_at": 1580442248
        },
        "msg": ""
    }

错误列表

错误状态码 | 错误描述信息
--- | ---
400 | ret=400，客户端参数错误或非法请求
404 | 表示接口服务不存在
406 | ret=406，access_token令牌校验不通过
407 | ret=407，app_key权限不足，或未知应用
408 | ret=408，当前用户禁止使用，或用户未登录
500 | 表示服务端内部错误

本文档生成时间：2021-03-25 15:10:55