/api/auth/register注册账号,成功后自动登录
认证:公开
创建新账号。邮箱与用户名均需唯一;密码至少 8 位且需同时包含字母和数字。注册成功后服务端会直接下发会话 Cookie,无需再次登录。为保证接口安全,同一 IP 每小时最多注册 5 次。
请求参数(JSON Body)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
email | string | 必填 | 邮箱地址,会转换为小写 |
username | string | 必填 | 3-20 位,仅字母 / 数字 / 下划线 |
password | string | 必填 | 8-128 位,需含字母与数字 |
请求示例
curl -i -X POST 'https://domain.moespark.dev/api/auth/register' \
-H 'Content-Type: application/json' \
-c cookies.txt \
-d '{
"email": "me@example.com",
"username": "moe_user",
"password": "S3curePassw0rd"
}'响应示例
HTTP/1.1 200 OK
Set-Cookie: session=...; HttpOnly; Secure; SameSite=Lax; Path=/
{
"ok": true,
"data": {
"id": 12,
"username": "moe_user"
}
}