# Argentine Rock Legends

Version: `1.0.0`

The Argentine Rock Legends is an example OpenAPI specification to test OpenAPI tools and libraries. Get all the data for [all artists](#getAllArtists).

>Inspired by [Scalar Galaxy](https://galaxy.scalar.com/)

## Resources

* https://github.com/enzonotario/vitepress-openapi
* https://github.com/OAI/OpenAPI-Specification

## Markdown Support

All descriptions *can* contain ~~tons of text~~ **Markdown**. [If GitHub supports the syntax](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax), chances are we’re supporting it, too. You can even create [internal links to reference endpoints](#createArtist).

<details>
  <summary>Examples</summary>

  **Blockquotes**

  > I love Argentine Rock. <3

  **Tables**

  | Feature          | Availability |
  | ---------------- | ------------ |
  | Markdown Support | ✓            |

  **Accordion**

  ```html
  <details>
    <summary>Using Details Tags</summary>
    <p>HTML Example</p>
  </details>
  ```

  **Images**

  Yes, there’s support for images, too!

  ![Placeholder image](https://images.placeholders.dev/?width=1280&height=720)

</details>

OpenAPI specification: [/openapi.json](/openapi.json)

## Servers

- `https://stoplight.io/mocks/enzonotario/argentine-rock/122547792`: Mock Server

## Security schemes

- `bearerAuth`: HTTP bearer. Send `Authorization: Bearer <token>`.
- `apiKeyHeader`: API key in header `X-API-Key`.

## Authentication

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

- [Authentication](/example/tags/Authentication.md)
  - [Create a user](/example/operations/createUser.md) `POST /api/v1/user/signup`
  - [Authenticate a user](/example/operations/loginUser.md) `POST /api/v1/user/login`

## Artists

Everything about `Argentine Rock artists` and their contributions to music history.

> **Note:** You will need to authenticate yourself to access some of these endpoints using the [Authenticate a user](/example/operations/loginUser.md) endpoint.

- [Artists](/example/tags/Artists.md)
  - [Get all artists](/example/operations/getAllArtists.md) `GET /api/v1/artists`
  - [Add a new artist](/example/operations/createArtist.md) `POST /api/v1/artists`
  - [Get an artist](/example/operations/getArtist.md) `GET /api/v1/artists/{artistId}`
  - [Update an artist](/example/operations/updateArtist.md) `PUT /api/v1/artists/{artistId}`
  - [Delete an artist](/example/operations/deleteArtist.md) `DELETE /api/v1/artists/{artistId}`
  - [Get all albums](/example/operations/getAllAlbums.md) `GET /api/v1/artists/{artistId}/albums`
  - [Add a new album](/example/operations/createAlbum.md) `POST /api/v1/artists/{artistId}/albums`
