Skip to content

登录 (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