登录 (Login)
Method: POST
Endpoint:
/api/v1/auth/login
请求参数
Body (JSON):
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username |
String / Number | 是 | 用户名,当前只支持 1 / 2 |
请求示例:
{
"username": "1"
}
响应示例
{
"data": {
"cookie": "<session-token>"
}
}
data.cookie 就是裸 session token,不包含 Path、Max-Age 等 Cookie 属性,也不设置 Set-Cookie 响应头。
后续请求可以这样传:
client-cookie: <session-token>
也支持完整 Cookie 字符串:
client-cookie: session=<session-token>
会话保存在内存中,暂不处理过期,服务重启后失效。
错误
401 / INVALID_CREDENTIALS:用户名不存在400:JSON 非法或缺少username