文档

测试

- 用户登陆

websocket测试

POST

/auth/app/token/login

接口描述

登陆接口（请求参数为URL参数）

请求头

参数名

类型

描述

必填

Authorization

string

客户端凭证（由服务端分配）；`Basic BASE64(app_key:app_secret)`；示例：Basic rforfrtyhjb==

必填

请求参数

参数名

类型

描述

必填

username

string

用户名

必填

password

string

密码

必填

grant_type

string

授权类型（移动端固定写server）

必填

响应参数

参数名

类型

描述

必填

access_token

string

示例：bffb54c0-b449-48e7-8098-f8d1597b0db8

必填

token_type

string

示例：bearer

必填

refresh_token

string

示例：bae5fc56-a84b-44c3-bd8a-d6cf3b9ee793

必填

expires_in

number

示例：43195

必填

scope

string

示例：server

必填

tenant_id

object

示例：null

必填

license

string

示例：made by pigx

必填

active

boolean

示例：true

必填

dept_id

object

示例：null

必填

user_id

number

示例：1

必填

username

string

示例：18507149951

必填

错误响应

参数名

类型

描述

必填

code

number

示例：1

必填

msg

string

示例：用户名或密码错误

必填

data

string

示例：用户名或密码错误

必填

说明 / 示例

**请求示例：** ```http POST /auth/app/token/login?username=18507149951&code=654321&grant_type=server&password=123 HTTP/1.1 Host: 192.168.0.101:9999 Authorization: Basic cGlnOnBpZw== ``` *注意参数在url上* 1. 客户端可以实现定时通过 `refresh_token` 刷新 `access_token`，维持客户端登陆状态 **响应：** ```json { "access_token": "bffb54c0-b449-48e7-8098-f8d1597b0db8", "token_type": "bearer", "refresh_token": "bae5fc56-a84b-44c3-bd8a-d6cf3b9ee793", "expires_in": 43195, "scope": "server", "tenant_id": null, "license": "made by pigx", "active": true, "dept_id": null, "user_id": 1, "username": "18507149951" } ```

上一篇 - 用户注册

nextDoc - 用户登出