接口
认证
无需认证。请求体
string
required
账户的用户名。
string
required
账户的密码。
响应
string
已登录用户的 id。
string
已登录用户的用户名。
string | null
若已设置则为邮箱，否则为 null。
string
用户角色，例如
"user" 或 "admin"。boolean
账户当前是否被禁用。
curl -X POST https://router.example.com:8080/v1/router/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"alice","password":"secret123"}' \
-c cookies.txt
{
"id": "user-abc123",
"username": "alice",
"email": "[email protected]",
"role": "user",
"disabled": false
}
认证与用户
登录咏唱引擎 ROUTER 会话
POST /v1/router/auth/login 校验用户名与密码并设置会话 Cookie，用于访问咏唱引擎 ROUTER 的管理面与数据面。
curl -X POST https://router.example.com:8080/v1/router/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"alice","password":"secret123"}' \
-c cookies.txt
{
"id": "user-abc123",
"username": "alice",
"email": "[email protected]",
"role": "user",
"disabled": false
}
用用户名和密码登录咏唱引擎 ROUTER。登录成功后服务端设置会话 Cookie，之后访问管理面与数据面的请求带上它即可。
Was this page helpful?