账号密码登录

正式环境

http://prod-cn.your-api-server.com

POST

/admin/auth/login

管理员账号密码登录。支持用户名、邮箱、手机号作为登录账号。

登录尝试受节流限制（后台配置 admin.login_throttle，默认 10,3 即每 3 分钟 10 次），超限返回 429。

密码错误或账号被禁用的登录尝试会记录到登录历史（result=false），可通过「管理员登录历史」接口查询；账号不存在的尝试不记录。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "account": "string",
    "password": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

Objective-C

Ruby

OCaml

Dart

cURLcURL-WindowsPowerShell

curl --location 'http://prod-cn.your-api-server.com/admin/auth/login' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "account": "string",
    "password": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "access_token": "string",
    "user": {
        "user_id": 0,
        "user_name": "string",
        "email": "string",
        "avatar": "string",
        "roles": [
            "string"
        ],
        "buttons": [
            "string"
        ]
    }
}

🟠422验证失败

🟠429请求过多

修改于 2026-08-27 06:04:20

认证授权说明

微信公众号登录