go-blog-api

Go Blog API

Real-world examples implementing back-end services for blog application using Go programming language to build RESTful API, all routes and API documentation can be found at {{base_url}}/swagger/index.html

Architecture

This project using Clean Architecture with 4 domain layers:

• Model
• Repository
• Service
• Handler

Features

• API Documentation Swagger (auto generate)
• Command line options
• Authentication Json Web Token
• CRUD operations Postgres (raw sql)
• Caching Redis
• Pagination, URL query search, etc
• Environment variables config
• Database Migrations, Rollbacks, Steps, Drop, etc
• Validation data request
• Middlewares CORS, Rate Limit, Logger, Recover, Custom, etc
• Graceful shutdown
• Many more...

System Requirements

• Golang
• Docker
• Postgres (included in docker compose)
• Redis (included in docker compose)

Running

Setting up all containers

$ make compose.up

Applying all up migrations and start the server

$ make launch

Destroy

Applying all down migrations

$ make rollbacks

Destroy running containers

$ make compose.down

Delete all volumes that doesn't used

$ docker volume prune

Environment Variables