用户登录

POST

/auth/login

最后修改时间：2026-10-27 11:26:06

责任人：未设置

x-owner-module：account

先获取 CSRF。登录成功设置新的 SGSESSION Cookie 并返回新的 csrfToken，后续写操作使用新令牌。

请求参数

Authorization

API Key

在 cookie 添加参数

SGSESSION

示例：

SGSESSION: ********************

Header 参数

Body 参数application/json必填

示例

{
    "username": "稳步用户01",
    "password": "DemoOnly123!"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/auth/login' \
--header 'X-CSRF-Token: klUsmPZaWyC8xZpWxIa6JekwAuSCaWklFEsHxcYnVCM' \
--header 'Content-Type: application/json' \
--data '{
    "username": "稳步用户01",
    "password": "DemoOnly123!"
}'

返回响应

🟢200成功（200）

application/json

登录并轮换会话及 CSRF 令牌

Headers

Bodyapplication/json

示例

{
    "code": "OK",
    "message": "OK",
    "data": {
        "user": {
            "id": "11111111-1111-4111-8111-111111111111",
            "username": "稳步用户01",
            "nickname": "木鸡测试员",
            "createdAt": "2026-10-11T10:00:00Z"
        },
        "csrfToken": "demo_csrf_token_not_for_production_123456"
    }
}

🟠401失败（401）

🟠403失败（403）

🟠413失败（413）

🟠415失败（415）

🟠422失败（422）

🟠429

🔴500失败（500）

⚪default其他失败

修改于 2026-10-27 11:26:06

用户注册

获取当前用户信息