Golang company api

Hosted URL

http://golangcompanyapi.herokuapp.com

Trivia

Created a separate folder especially for validations. Validations are done for every end point via middleware style. All the API calls respond in same style, giving consistency and symmetry to response either errors or success responses. Example of success result { status:"success",message:"successfully fetched",data: {} } Example of error result {status:"error",message:"id param is required"}

Finally Same project is done using nodejs maintaining same standards https://github.com/RTBathula/nodeapp

Getting Started

Fork and clone the repository. Install dependencies with:

go install

Database connection

Run MongoDB locally or run through service and add MongoDB connection string config/keys.js file

Example: under config/keys.js

{
  development : {
    mongoDBConnection: "mongodb://localhost:27017"
  }
}

Run Server

After completing all above steps run your golang server

go run main.go

Can I deploy docker image in heroku?

Yes, As dockerfile is written for this project, you can deploy to heroku using simple heroku commands. Here is how.

##Direct image push to heroku from project workspace(main commands)

heroku create
heroku container:push web
heroku ps:scale web=1

##Using existing docker image from (rtbathula/golangapp)

docker tag rtbathula/golangapp registry.heroku.com/<heroku-app-name>/web
docker push registry.heroku.com/<heroku-app-name>/web
heroku ps:scale web=1

For more info, look here https://devcenter.heroku.com/articles/container-registry-and-runtime

API End points and usage

Create company POST -> http://localhost:3000/company

Example CURL Request:

curl -X POST -H "Accept: application/json" -H "Content-Type: application/json" -d '{"name":"starbucks","address":"costanera center","city":"santiago","country":"chile","email":"rtbathula@sbucks.com","phone":"123456789","directors":[{"name":"rtbathula","email":"director1@sbucks.com"}],"beneficials":[{"name":"hello","email":"beneficial1@sbucks.com"}]}' http://localhost:3000/company

Result:

{
  "status"  : "success",
  "message" : "Successfully created a company" ,
  "data"    : {created company object}
}

Parameters

Parameter	Type	Description
name	string	company name
address	string	company address
city	string	company city
country	string	company country
email(optional)	string	company email
phone(optional)	string	company phone
directors	json array	company directors. see below for params
beneficials	json array	comapny beneficials. see below for params

Directors and Beneficials Parameters

Parameter	Type	Description
name	string	name
email	string	email

Get company details GET -> http://localhost:3000/company/{companyid}

Example CURL Request:

curl -X GET  http://localhost:3000/company/{companyid}

Result:

{
  "status"  : "success",
  "message" : "Successfully fetched the company details" ,
  "data"    : {company object}
}

Get company list GET -> http://localhost:3000/company?skip=0&limit=3

Example CURL Request:

curl -X GET  http://localhost:3000/company

Result:

{
  "status"  : "success",
  "message" : "Successfully fetched the company list" ,
  "data"    : [{company object}]
}

Optional skip and limit query params

Parameter	Type	Description
skip	integer	0
limit	integer	2

Update company PUT -> http://localhost:3000/company/{companyid}/update-company

Example CURL Request:

curl -X PUT -H "Accept: application/json" -H "Content-Type: application/json" -d '{"address":"hyderabad","city":"hyderabad","country":"india","email":"new@gmail.com","phone":"123456789"}' http://localhost:3000/company/{companyid}/update-company

Result:

{
  "status"  : "success",
  "message" : "Successfully update the company" ,
  "data"    : {updated company object}
}

Parameters(any one of them is need to update company)

Parameter	Type	Description
address	string	company address
city	string	company city
country	string	company country
email	string	company email
phone	string	company phone

Add beneficial PUT -> http://localhost:3000/company/{companyid}/add-beneficial

Example CURL Request:

curl -X PUT -H "Accept: application/json" -H "Content-Type: application/json" -d '{"name":"beneficial name","email":"beneficial@sbucks.com"}' http://localhost:3000/company/{companyid}/add-beneficial

Result:

{
  "status"  : "success",
  "message" : "Successfully added the new beneficial" ,
  "data"    : {added beneficial object}
}

Parameters

Parameter	Type	Description
name	string	beneficial address
email	string	company email

Love ❤️ to hear feedback from you

RT Bathula-weirdo,coffee lover battu.network@gmail.com