Register | Auth API

Request

RegisterRequest

RegisterRequestapi.v1.auth.RegisterRequest3 fields

RegisterRequest contains the information required to create a new user account.

username

string

The desired unique username for the new account.

password

string

The plain-text password for the new account.

captchaResponse

string

The response token from a captcha challenge to verify the requester is human.

Request JSON

{
  "username": "fireanime_user",
  "password": "your-password",
  "captchaResponse": "captcha-token"
}

Response

AuthResponse

AuthResponseapi.v1.auth.AuthResponse2 fields

AuthResponse contains the session information returned after successful authentication.

token

string

The JWT (JSON Web Token) used for subsequent authenticated requests.

isAdmin

bool

Indicates whether the authenticated user has administrative privileges.

Example response

{
  "token": "eyJhbGciOiJIUzI1NiJ9…",
  "isAdmin": true
}

Error handling

Common failure codes

invalid_argumentThe request payload failed validation.

internalThe service could not complete the operation.

Request example

curl 'https://fireani.me/api.v1.auth.AuthService/Register' \
  -X POST \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "username": "fireanime_user",
  "password": "your-password",
  "captchaResponse": "captcha-token"
}'