API docs by Redocly

Ecommerce APIs (1.0.0)

Download OpenAPI specification:

License: MIT

Auth

Login user

Authenticates a user and sets access/refresh token cookies.

query Parameters
mode
string
Value: "json"

Optional. Use json to return tokens in response body (for tooling/testing).

Request Body schema: application/json
required
username
required
string <email>
password
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "username": "user@example.com",
  • "password": "YourP@ssword123"
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "username": "user@example.com"
}

Logout user

Invalidates refresh token and clears auth cookies.

Authorizations:
bearerAuth
header Parameters
X-Refresh-Token
required
string

Refresh token (JWT). Provide the refresh token returned by /logout.

Responses

Response samples

Content type
application/json
{
  • "message": "Logged out successfully"
}

Refresh access token

Rotates tokens using refresh token cookie.

Authorizations:
bearerAuth
header Parameters
X-Refresh-Token
required
string

Refresh token (JWT). Provide the refresh token returned by /login.

Responses

Response samples

Content type
application/json
{
  • "message": "Tokens refreshed"
}