Sampark

Introduction

Sampark is a contact book REST API written in Golang. It uses MongoDB as the primary data store and is built using SOLID design priciples and 12-Factor App methodology in mind.

API Specification

• GET /v1/health Health check to indicate API health
• POST /v1/contacts Creates a contact
• GET /v1/contacts Lists and searches contacts
• GET /v1/contacts/{id} Fetches contact by ID
• PATCH /v1/contacts/{id} Updates a contact
• DELETE /v1/contacts/{id} Deletes contact by ID

API Remarks

• API has been hosted on Heroku (https://sampark.herokuapp.com)
• API supports CRUD operations on Contact entity
• Each contact has a unique email address, which is ensured by having a unique index on the email field
• Allows searching by name and email address. GET /v1/contacts?name=<NAME>&email=<EMAIL> lets you search via name and/or email
• Search supports pagination and returns 10 items by default per invocation. Example: GET /v1/contacts?page=1&limit=5.
• Added tests for each functionality
• Basic authentication has been added using environment variables
• Some preliminary load tests will ensure that the code can scale-out for millions of contacts

Error Codes

Development

Pre-requisites: Install latest stable versions of Docker and Docker Compose.

1. Clone the repository locally.
2. Add .env file in the repository root by modifying the .env.template file as needed.
3. From repository root, run:

make start

1. API will be up and running at http://localhost:5000.

Testing

From repository root, run:

make test

Dependency Management

Sampark uses Go modules with semantic versioning and is tested with Go 1.12+.

• Update all direct and indirect dependencies using go get -u.
• Remove unused dependencies using go mod tidy.
• Add a new dependency using go get <path-to-dependency>.

Dependencies

• echo - Web framework
• realize - Live reloading
• mgo.v2 - MongoDB driver
• testify - Assertions library

References

• Go Modules

Acknowledgements

Logo credit goes to Freepik from Flaticon and is licensed under Creative Commons BY 3.0.