go-api

• When adding new imports within the app, to update go.mod and go.sum, run:

make dep

• Run database migrations:

make db_migrate

• There are predefined fixtures like users, companies etc... inside cmd/storage, to seed database with that data:

make db_seed

• Create a new database migration file:

make db_create_migration file=create_bananas

• Drop dev database. This will stop docker volumes and delete the database volume, after running this command to get your database restored to use API, you'll need to run a migration and seed commands

make db_drop

• Open psql console inside postgres container:

make psql_console

• Run bash console inside API container:

make bash

• Run API integration tests:

make test_api

• Run models unit tests:

make test_models

• There is a standalone Admin CMS API cmd/admin that uses the same Models layer as a main API, to start admin API:

make admin

• Cron jobs example is in cmd/cron, to run cron jobs:

make cron

• Health check

curl http://localhost:8000/health

• Versions

curl http://localhost:8000/version

• Anon user init data. Provides data in jsonapi schema for a guest user

curl http://localhost:8000/ | json_pp

• Sign In. Response headers will hold authentication jwt that can be used to call auth endpoints

curl -H "Content-Type: application/json" -X POST -d '{"email": "user1@example.com", "password": "goapi123"}' http://localhost:8000/login | json_pp

• Authenticated user init data. Provides data in jsonapi schema for an authenticated user

curl -H "Content-Type: application/json" -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjoxfQ.VEy5T2jj4rIr2Sfs_mif0uKTi9GyX2eAi4_QYcL673o" http://localhost:8000/ | json_pp