An open API service indexing awesome lists of open source software.

https://github.com/charlesmartinreed/album-api-project


https://github.com/charlesmartinreed/album-api-project

Last synced: 4 months ago
JSON representation

Awesome Lists containing this project

README

        

# Album API Project

### Just a barebones API used as an backend for a similarly simple web-based music player UI/UX study project, [which can be found here]('https://github.com/charlesmartinreed/design-study-side-panel-ux').

## ROUTES

### GET

- `/api/albums` - returns the full album object, including artist, track list, genre, etc.
- `/api/albums/?limit={limit_value}` - returns the requested number of albums from a pool of album objects, randomized.
- `/api/albums/?search={search_value}` - queries the database for a matching property -- currently `album title` or `song title` -- and returns the full album object for parsing, as JSON.
- `/api/albums/trending` - returns albums that are trending, as well as where they are trending (local, region, global).
- `/api/album/:albumId` - returns a specific album from the database, using the URL param for albumID.

### POST

- `/api/album/:albumId` - used by the front-end client to update album objects; client sends a POST request JSON object containing a prop to update and the value to update it with.