Authentication

Register a new user

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstring · emailRequired

passwordstringRequired

Responses

200

User registered successfully

application/json

codestringOptional

Response code (e.g., MEMBER_REGISTER_SUCCESS)

messagestringOptional

Human-readable message

dataobject · nullableOptional

400

Invalid request (e.g., validation error, email exists)

post

/api/v1/auth/signup

HTTPcURLJavaScriptPython

POST /api/v1/auth/signup HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "email": "[e-mail]",
  "password": "text"
}

{
  "code": "text",
  "message": "text",
  "data": {}
}

Login an existing user

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

emailstring · emailRequired

passwordstringRequired

Responses

200

Login successful, tokens returned

application/json

codestringOptional

messagestringOptional

400

Invalid credentials

401

Authentication failed

post

/api/v1/auth/login

HTTPcURLJavaScriptPython

POST /api/v1/auth/login HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "email": "[e-mail]",
  "password": "text"
}

{
  "code": "text",
  "message": "text",
  "data": {
    "accessToken": "text",
    "refreshToken": "text"
  }
}