Assignment 1 - REST API design

/login?user&pass
/artist /:name,:id /song /:name,:id /review /:id

C - POST
R - GET
U - PUT
D - DELETE

---------------------------------------------------------

                /login

POST:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
GET:
    Purpose:
        - Validate login credentials
    Paramaters:
        - user
        - pass
    Responses:
        - 202       Valid Information                            Token
        - 502       Invalid Information
        - 503       Something has occured, try again later
PUT:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
DELETE:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call

---------------------------------------------------------

                /artist

POST:
    Purpose:
        - Create new artist
    Requirements:
        - Valid token
    Responses:
        - 201       Created Artist
        - 401       Invalid authorization
        - 503       Something has occured, try again later
GET:
    Purpose:
        - Get a list of all artists
    Requirements:
        - Valid token
    Responses:
        - 200       Got list of all artists                     listOfArtists
        - 401       Invalid authorization
        - 503       Something has occured, try again later
PUT:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
DELETE:
    Purpose:
        - Remove all artists owner by user
    Requirements:
        - Valid token
    Responses:
        - 202       Removed all artists owner by user
        - 401       Invalid authorization
        - 503       Something has occured, try again later

---------------------------------------------------------

                /artist/:id,:name

POST:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
GET:
    Purpose:
        - Get details of given artist
    Requirements:
        - Valid token
    Responses:
        - 200       Got info of artist                      artistInfo
        - 401       Invalid authorization
        - 503       Something has occured, try again later
PUT:
    Purpose:
        - Update an artist
    Requirements:
        - Valid token
    Responses:
        - 202       Updated artist
        - 401       Invalid authorization
        - 503       Something has occured, try again later
DELETE:
    Purpose:
        - Remove an artist
    Requirements:
        - Valid token
    Responses:
        - 202       Removed artist
        - 401       Invalid authorization
        - 503       Something has occured, try again later

---------------------------------------------------------

                /artist/:id,:name/song

POST:
    Purpose:
        - Create new song
    Requirements:
        - Valid token
    Responses:
        - 201       Created Song
        - 401       Invalid authorization
        - 503       Something has occured, try again later
GET:
    Purpose:
        - Get a list of all songs
    Requirements:
        - Valid token
    Responses:
        - 200       Got list of all songs                       listOfAllSongs
        - 401       Invalid authorization
        - 503       Something has occured, try again later
PUT:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
DELETE:
    Purpose:
        - Remove all songs by artist
    Requirements:
        - Valid token
    Responses:
        - 202       Removed all songs by artist
        - 401       Invalid authorization
        - 503       Something has occured, try again later

---------------------------------------------------------

                /artist/:id,:name/song/:id,:name

POST:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
GET:
    Purpose:
        - Get details of given song
    Requirements:
        - Valid token
    Responses:
        - 200       Got info of song                        songInfo
        - 401       Invalid authorization
        - 503       Something has occured, try again later
PUT:
    Purpose:
        - Update a song
    Requirements:
        - Valid token
    Responses:
        - 202       Updated song
        - 401       Invalid authorization
        - 503       Something has occured, try again later
DELETE:
    Purpose:
        - Remove a song
    Requirements:
        - Valid token
    Responses:
        - 202       Removed song
        - 401       Invalid authorization
        - 503       Something has occured, try again later

---------------------------------------------------------

                /artist/:id,:name/song/:id,:name/review

POST:
    Purpose:
        - Create new review
    Requirements:
        - Valid token
    Responses:
        - 201       Created review
        - 401       Invalid authorization
        - 503       Something has occured, try again later
GET:
    Purpose:
        - Get a list of all reviews
    Requirements:
        - Valid token
    Responses:
        - 200       Got list of all reviews                     listOfAllReviews
        - 401       Invalid authorization
        - 503       Something has occured, try again later
PUT:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
DELETE:
    Purpose:
        - Remove all reviews on song
    Requirements:
        - Valid token
    Responses:
        - 202       Removed all reviews on song
        - 401       Invalid authorization
        - 503       Something has occured, try again later

---------------------------------------------------------

                /artist/:id,:name/song/:id,:name/review/:id

POST:
    Purpose:
        - Not valid API call
    Responses:
        - 501       Invalid API call
GET:
    Purpose:
        - Get details of given review
    Requirements:
        - Valid token
    Responses:
        - 200       Got info of review                      reviewInfo
        - 401       Invalid authorization
        - 503       Something has occured, try again later
PUT:
    Purpose:
        - Update a review
    Requirements:
        - Valid token
    Responses:
        - 202       Updated review
        - 401       Invalid authorization
        - 503       Something has occured, try again later
DELETE:
    Purpose:
        - Remove a review
    Requirements:
        - Valid token
    Responses:
        - 202       Removed review
        - 401       Invalid authorization
        - 503       Something has occured, try again later