🎹 Artiz MoNo API 🥁

An API that lists artists and their songs. Authenticated users can perform actions such as liking a song, following an artist and creating playlists.

Technologies used: MongoDB, NodeJS, Mongoose and Docker.

Features

• custom user auth
• artists list
• single artist
• follow artist
• song list per artists
• liked songs
• create playlists
• user profile
• pagination

Usage and Info

git clone git@github.com:raptisj/artiz-mono-api.git
cd ./artiz-mono-api

To run:

docker-compose up —-build

To connect to a MongoDB shell:

docker exec -it mongodb /bin/bash
mongosh

Info: MongoDB shell commands cheatsheet

Info: Get started with MongoDB and Mongoose

Generate data

I used ChatGPT to generate the data. To do so youself you can insert the prompts from the data/prompts/index.md file. Replace curly braces with your intended value

Import data

In the data folder there are two JSON files.

First, we need to copy each file to the container. Second, we need to run mongoimport to populate the database.

Note: Mongo usually generates an _id of type ObjectId for us. Here we add it explicitly in a format that mongoimport can understand in order to generate an _id in the correct format.

docker cp ./data/artists.json mongodb:/artists.json \
&& docker exec mongodb mongoimport --db mono --collection artists --drop --file /artists.json --jsonArray --mode upsert \
&& docker cp ./data/songs.json mongodb:/songs.json \
&& docker exec mongodb mongoimport --db mono --collection songs --drop --file /songs.json --jsonArray --mode upsert

To try out the API you can use Postman. Register a user and copy the access token in the response to your clipboard. Paste it in the Authorization > Bearer Token section in the token field.

Structure of data

Artist

[
  {
    "_id": "5fc612c4397f9b74b2e8c266",
    "name": "Pat Metheny",
    "birth_year": 1954,
    "instrument": "Guitar",
    "genre": "Jazz",
    "bio": "Pat Metheny is an American jazz guitarist known for his innovative and diverse musical style. He has won numerous awards, including 20 Grammy Awards across various categories. Metheny's work spans jazz fusion, contemporary jazz, and beyond, showcasing his virtuosity and creativity.",
    "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/4c/Pat_Metheny.jpg/500px-Pat_Metheny.jpg"
  }
]

Song

[
  {
    "_id": "5fc6140f397f9b74b2e8c268",
    "artist_id": "5fc612c4397f9b74b2e8c266",
    "title": "Last Train Home",
    "album": "Still Life (Talking)",
    "year": 1987,
    "duration": "5:42",
    "genre": "Jazz Fusion",
    "added_to_playlist_dates": "2023-11-24T18:38:34.064Z" // only visible within a playlist
  }
]

User

[
  {
    "_id": "09d6140f397f5b74b4e8c244",
    "username": "doe",
    "email": "joe@doe.com",
    "liked_songs": ["1", "2", "3"],
    "following": ["11", "22", "33"]
  }
]

Playlist

[
  {
    "_id": "09d6140f397f5b74b4e8c244",
    "user_id": "9d6147f58c244b700f394b4e",
    "song_ids": ["1", "2", "3"],
    "title": "Jazz hits",
    "description": "A smooth collection",
    "song_count": 4,
    "total_track_duration_in_seconds": 1123123,
    "total_track_duration": "1h 20m" // from a virtual
  }
]

Author

John Raptis