Building a Blog API in Go

---

This repository describes building a blog API to post, retrieve, update and delete contents. I have also written an article on medium that ties to this repository.

Building an Image

For Local Operation

• docker build . -t blogapi #build the image
• docker run -d -p 8080:8080 --name blogapi blogapi #run the image

For Remote Operation

• TAG=git tag -l | tail -n1 && echo $TAG #get the latest project tag
• docker login #provide your dockerhub user name and password
• docker build . -t knoxknot/blogapi:$TAG -t knoxknot/blogapi:latest #build the image for push to repository
• docker push knoxknot/blogapi:$TAG #push image to repository
• docker push knoxknot/blogapi:latest

Testing the Endpoints Using Curl

• curl -X GET http://localhost:8080/api/v1/articles | jq . #to retrieve all articles.
• curl -X GET http://localhost:8080/api/v1/articles/2 | jq . #to retrieve a specific article by id.
• curl -X POST http://localhost:8080/api/v1/articles -d '{"ID": "4","Title": "Go: Clean, Readable and Fast","Content": "It is clean in design, easy to read and outputs very fast."}' -H "Content-Type: application/json" | jq . #to create an article.
• curl -X PUT http://localhost:8080/api/v1/articles/4 -d '{"ID":"4","Title":"Go is Clean and Readable","Content":"It is clean in design, easy to read and outputs very fast."}' -H "Content-Type: application/json" | jq . #to update a specific article with a given id.
• curl -X DELETE http://localhost:8080/api/v1/articles/4 | jq . #to delete an article by id.