nexlink/docs/api/auth.md
2026-01-01 17:07:12 +01:00

941 B

POST /api/v1/auth/register

Request:

{
    "username": "string",
    "password": "string",
    "email": "string?"
}

Registers a new user

Response (success):

{
    "id": "string",
    "username": "string",
    "registerDate": "number"
}

Response (error):

{
    "error": "user already exists"
}

POST /api/v1/auth/login

Request:

{
    "username": "string",
    "password": "string"
}

Logs in a user and returns a new session cookie

Response (success):

{
    "id": "string",
    "ownerId": "string"
}

Response (incorrect credentials):

{
    "username": "string",
    "error": "incorrect credentials"
}

GET /api/v1/auth/refresh

Creates and returns an authorization token for the current session using session cookie

Response (success):

{
    "id": "string",
    "ownerId": "string",
    "token": "string"
}