README.md

go-crud-dynamodb-gofiber

Simple of CRUD REST API backed by DynamoDB wrote in Golang based on AWS SDK V2

TECH STACK

• GOLANG 1.16.3
• GOFIBER v2
• AWS SDK GO V2

Getting Started

Pre-requirements

• In your machine install AWS-CLI and CONFIGURE to save configuration of the your database
• You also need DOCKER

Install

If you already have golang installed you can install packages by running the command:

go get -u ./...

Start DynamoDB local

docker run -p 8000:8000 amazon/dynamodb-local

Create Table

go run scripts/createTable.go

Verify that the table is created:

go run scripts/listTable.go

You should see:

0 Books

Init server

To start the project run the command:

go run api/main.go

You can see in your terminal this log: service running on port :3000

Usage

Base Route

    GET - http://localhost:3000/

Post

This route creates an item in your database

    POST - http://localhost:3000/api/books

    {
        "Title": "WhyJavaSucks"
        "Author": "me"
    }

curl -d "Title=WhyJavaSucks&Author=Me" -X POST -H "Accept: application/json" http://localhost:3000/api/books

Get_All

This route returns all data in your database

    GET - http://localhost:3000/api/books

Put

This route updates an item in your database

    PUT - http://localhost:3000/api/books/
    {   
        "Title": "WhyJavaSucks"
        "Author": "me"
        "Rate": "0.8"
    }

or

curl -d "Title=WhyJavaSucks&Author=Me&Rating=0.8" -X PUT -H "Accept: application/json" http://localhost:3000/api/books

Delete

This route removes an item in your database

    DELETE - http://localhost:3000/api/books/
    {   
        "Title": "WhyJavaSucks"
        "Author": "me"
    }