This is a simple API written in Go using the Gin framework. Its an example of how to create a RESTful web service to manage a collection of resources. In this case, music albums (in a record shop perhaps). The API allows users to:

• Recieve a list of all albums maintained (GET)
• Retrieve a single album using its ID (GET)
• Add a new album to the collection (POST)
• Edit data stored for an album (PUT)
• Delete an album entry (DELETE)

The project is based on the Go Web Service with Gin tutorial.

To run this project, you'll need:

• Go installed on your system
• Gin package (go get -u github.com/gin-gonic/gin)

1. Clone this repository and navigate to the project directory.

2. Install the necessary dependencies:

         `go mod tidy`
   

3. Run the application:

         `go run main.go`
   

4. The server will start, and you can access the API on http://localhost:8888 using this line:

         `curl http://localhost:8888`
   

   You can use any port available on your host machine, of course. This is just the one I have chose arbitrarily.

Method: GET
Endpoint: /albums/:id
Description: Return data for a single album from the list in JSON format.

Example response:

[
  {
    "id": "001",
    "title": "My Beautiful Dark Twisted Fantasy",
    "artiste": "Kanye West",
    "year": 2010,
    "price": 59.99
  },
]

Method: GET
Endpoint: /albums
Description: Return the full list of albums in JSON format.

Method: POST
Endpoint: /albums
Description: Add a new album to the collection. Requires a JSON body for album information. Returns a message confirming the addition and the sequentially assigned unique ID \

Example request:

{
  "id": "005",
  "title": "New Album",
  "artiste": "New Artist",
  "year": 2024,
  "price": 29.99
}

Example response:

{
    "message": "Added 'Love (Deluxe)' by Sade at ID 007"
}

Method: PUT
Endpoint: /albums/:id
Description: Update the album stored at an ID in the resource list. Currently necessary to send a request body complete with all resource parameters. A fix for this is pending - you will soon be able to send only the parameter you wish to update for a spcific resource.

Method: PUT
Endpoint: /albums/:id
Description: Remove a resource from the list where they are stored, identified by its ID. (This is an opportunity for me to mention that I will soon be implementing a simpler way of looking up resources: by the names of the artiste, or the album)