Song Microservice

A Spring Boot project (which I created to learn Spring Cloud).
It implements different RESTful endpoints which are explained here.
Javadoc

Deployment

clone repository
create PostgreSQL db with 3 DBs (User, Concerts and Playlist)
use user.sql, concerts.sql and playlist.sql to create tables in the corresponding DB (files are under the resources folder)
setup env variables:
- SONGS_PASSWORD=db_password
- SONGS_HOST=db_ip
- KBE_DB_USER=db_user
- SECRET_KEY_KBE=key_used_to_create_JWT
run all mains
- Authorization Microservice
- Song Microservice
- Concert Microservice
- Eureka Microservice
- Gateway Microservice

Endpoints

Endpoints documentation of Song web application.

AUTH

Authorisation Endpoints.

1. Auth User

Get JWT for User 1.

Endpoint:

Method: POST
Type: RAW
URL: http://localhost:8080/songsWS/rest/auth

Body:

{"userId":"mmuster","password":"pass1234"}

2. Auth User 2

Get JWT for User 2.

Endpoint:

Method: POST
Type: RAW
URL: http://localhost:8080/songsWS/rest/auth

Body:

{"userId":"eschuler","password":"pass1234"}

CONCERT

Concert endpoints.

1. Delete a ticket

Delete ticket by ID.

Endpoint:

Method: DELETE
Type: 
URL: http://localhost:8080/songsWS/rest/tickets/1

Headers:

Key	Value	Description
Authorization	JWT

2. Get Concert by ID

Get concert by ID.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/concerts/1

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

3. Get Ticket

Get Ticket by ID.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/tickets

Headers:

Key	Value	Description
Authorization	JWT

Query params:

Key	Value	Description
buyConcert	1

4. Get Ticket QR

Get Ticket QR Code.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/tickets/1

Headers:

Key	Value	Description
Authorization	JWT

5. Get all Concerts

Get all concerts.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/concerts/

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

6. Get all user tickets

Get all tickets for user.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/tickets/

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

7. Post a new concert

Post a new Concert.

Endpoint:

Method: POST
Type: RAW
URL: http://localhost:8080/songsWS/rest/concerts/

Headers:

Key	Value	Description
Authorization	JWT

Body:

{
    "location": "Berlin",
    "artist": "Britney Spears",
    "maxTickets": 10
}

PLAYLIST

Playlists endpoints.

1. Delete a specific Playlist

Delete a playlist by ID.

Endpoint:

Method: DELETE
Type: 
URL: http://localhost:8080/songsWS/rest/songLists/2

Headers:

Key	Value	Description
Authorization	JWT

2. Get all user playlists

Get all the playlists from a User, if you own the playlist private and public will be returned else only public.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/songLists

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

Query params:

Key	Value	Description
userId	mmuster

3. Get specific user playlists

Get a specific playlist by ID.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/songLists/2

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

4. Post a playlist

Post a new Playlist.

Endpoint:

Method: POST
Type: RAW
URL: http://localhost:8080/songsWS/rest/songLists

Headers:

Key	Value	Description
Authorization	JWT
Content-Type	application/json

Body:

{
    "name": "Mmuster's Private Playlist 2",
    "isPrivate": true,
    "songList": [
        {
            "id": 4,
            "title": "Ghostbusters (I'm not a fraid)",
            "artist": "Fall Out Boy, Missy Elliott",
            "label": "Ghostbusters",
            "released": 2016
        },
        {
            "id": 5,
            "title": "Bad Things",
            "artist": "Camila Cabello, Machine Gun Kelly",
            "label": "Bloom",
            "released": 2017
        }
    ]
}

5. Update a Playlist

Update a playlist.

Endpoint:

Method: PUT
Type: RAW
URL: http://localhost:8080/songsWS/rest/songLists/5

Headers:

Key	Value	Description
Authorization	JWT
Content-Type	application/json

Body:

{
    "id": 5,
    "name": "Mmuster's Public Playlist 2 NEW",
    "isPrivate": false,
    "songList": [
        {
            "id": 8,
            "title": "No",
            "artist": "Meghan Trainor",
            "label": "Thank You",
            "released": 2016
        },
        {
            "id": 9,
            "title": "Private Show",
            "artist": "Britney Spears",
            "label": "Glory",
            "released": 2016
        }
    ]
}

SONG

Song service endpoints.

1. Delete Song by ID

Delete a song from ID.

Endpoint:

Method: DELETE
Type: 
URL: http://localhost:8080/songsWS/rest/songs/5

Headers:

Key	Value	Description
Authorization	JWT

2. Get Song by ID

Get a Song by the ID.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/songs/1

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

3. Get Songs from Artist

Get all songs from given artist.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/songs

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

Query params:

Key	Value	Description
artist	Justin Timberlake

4. Get all Songs

Get all available songs.

Endpoint:

Method: GET
Type: 
URL: http://localhost:8080/songsWS/rest/songs/

Headers:

Key	Value	Description
Authorization	JWT
Accept	application/json

5. Post a Song

Post a new Song.

Endpoint:

Method: POST
Type: RAW
URL: http://localhost:8080/songsWS/rest/songs/

Headers:

Key	Value	Description
Authorization	JWT

Body:

{
    "title": "Can’t Stop the Feeling",
    "artist": "Justin Timberlake", 
    "label": "Trolls",
    "released": 2016
}

6. Post a Song JSON File

Post a new Song as JSON File.

Endpoint:

Method: POST
Type: FILE
URL: http://localhost:8080/songsWS/rest/songs/

Headers:

Key	Value	Description
Authorization	JWT

7. Put a Song

Update a Song.

Endpoint:

Method: PUT
Type: RAW
URL: http://localhost:8080/songsWS/rest/songs/3

Headers:

Key	Value	Description
Authorization	JWT
Content-Type	application/json

Body:

{
    "id": 3,
    "title": "SONG_TITLE_EDIT",
    "artist": "COOL Artitst_EDIT", 
    "label": "SONY_EDIT",
    "released": 2021
}

Back to top

Name		Name	Last commit message	Last commit date
Latest commit History 43 Commits
authorization		authorization
cloudGateway		cloudGateway
concerts		concerts
eureka-service		eureka-service
songs		songs
.gitignore		.gitignore
README.md		README.md
pom.xml		pom.xml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Song Microservice

Deployment

Endpoints

Indices

AUTH

1. Auth User

2. Auth User 2

CONCERT

1. Delete a ticket

2. Get Concert by ID

3. Get Ticket

4. Get Ticket QR

5. Get all Concerts

6. Get all user tickets

7. Post a new concert

PLAYLIST

1. Delete a specific Playlist

2. Get all user playlists

3. Get specific user playlists

4. Post a playlist

5. Update a Playlist

SONG

1. Delete Song by ID

2. Get Song by ID

3. Get Songs from Artist

4. Get all Songs

5. Post a Song

6. Post a Song JSON File

7. Put a Song

About

Languages

enricoDec/Song-microservice

Folders and files

Latest commit

History

Repository files navigation

Song Microservice

Deployment

Endpoints

Indices

AUTH

1. Auth User

2. Auth User 2

CONCERT

1. Delete a ticket

2. Get Concert by ID

3. Get Ticket

4. Get Ticket QR

5. Get all Concerts

6. Get all user tickets

7. Post a new concert

PLAYLIST

1. Delete a specific Playlist

2. Get all user playlists

3. Get specific user playlists

4. Post a playlist

5. Update a Playlist

SONG

1. Delete Song by ID

2. Get Song by ID

3. Get Songs from Artist

4. Get all Songs

5. Post a Song

6. Post a Song JSON File

7. Put a Song

About

Topics

Resources

Stars

Watchers

Forks

Languages