Skip to content

Authentication

Some endpoints are public, but some require authentication. We provide all the required endpoints to create an account and authorize yourself.


Create a user

POST
/api/v1/user/signup

Create a user account to access exclusive content about Argentine Rock legends. After signing up, you can access endpoints like GETGet all artists to explore the data.

Request Body

application/json
JSON
{
"name": "Carlos",
"email": "carlos@rock-legends.com",
"password": "i-love-rock"
}

Responses

User Created Successfully

Your account has been created and you can now access the Argentine Rock Legends API.

Response Details

The response includes your user information (excluding the password) and your API key for authentication.

Important: Save your API key securely as it will be needed for authenticated requests.

application/json
JSON
{
"id": 1,
"name": "Carlos",
"email": "carlos@rock-legends.com"
}

Playground

Body

Samples


Authenticate a user

POST
/api/v1/user/login

Authenticate with your credentials to access protected endpoints in the Argentine Rock Legends API.

Request Body

application/json
JSON
{
"email": "carlos@rock-legends.com",
"password": "i-love-rock"
}

Responses

Authentication Successful

You have been successfully authenticated.

Response Details

The response includes:

  • Your user information
  • Authentication tokens (JWT token and API key)
  • Token expiration information

Important: Store these credentials securely and include them in subsequent API requests.

application/json
JSON
{
"user": {
"id": 1,
"name": "Carlos",
"email": "carlos@rock-legends.com"
},
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"api_key": "rock-legends-api-key-12345",
"expires_at": "2025-08-26T19:28:00Z"
}

Playground

Body

Samples


Powered by VitePress OpenAPI