Categorygithub.com/GaryJX/golang-api-example
modulepackage
0.0.0-20210118021207-57595c4f3816
Repository: https://github.com/garyjx/golang-api-example.git
Documentation: pkg.go.dev
Overview
Versions
1
Dependencies
10
Dependents
0
Files
332 SLOC

# README

Golang API Example by GaryJX

Live example deployed at https://garyjx-golang-api-example.herokuapp.com/api/ (first load may be a bit slow due to cold start)

Local Development Commands

  1. Ensure that you have Golang installed on your machine (This repo uses v1.15.6).
  2. Ensure that you have PostgreSQL installed on your machine. Create 2 empty databases (one for playground and one for running tests).
  3. Clone the repo: git clone https://github.com/GaryJX/golang-api-example.git
  4. Change directory: cd golang-api-example
  5. Configure environment variables for your postgres connection: cp .env.sample .env
  6. Run tests: go test -v
  7. Install go-swagger here or run:
go get -u github.com/go-swagger/go-swagger/cmd/swagger
  1. Re-generate Swagger API docs: swagger generate spec -o ./api/swagger.json
  2. Start server:
go build
./golang-api-example.exe
  1. View API at http://localhost:8080/api/

Resources

# Structs

App contains Router and Database connection.
Error Not Found swagger:response notFoundResponse.
Status OK swagger:response okResponse.
Product Model.
Product Response Payload swagger:response productResponse.
Products Response Payload swagger:response productsResponse.