Micro-services Using Go-kit: REST Endpoint

In this article, I will create a simple micro-service using Go programming language and go-kit as a standard micro-services library. The service will be exposed via REST endpoint.

Sharing is caring!


In the today’s world, the micro-services architecture has gain its popularity. I will not explain what is micro-services architecture in particular, since there are lots of sites on the internet already discussed about this. However, I will give two good websites regarding micro-service.

Firstly from one of my favorite, Martin Fowler. You can see his amazing explanation here. And the other one is from microservices.io. There are many good articles inside talking about pattern and examples.


golangGo is an open source programming language that makes it easy to build simple, reliable, and efficient software¹.

The language is designed by Google and intended to solve Google’s problems. So one can hope that this language work on a scale, for large programs and dependencies.



Go-kit really helps for simplifying in terms of building micro-services architecture. This is  because it has so many features, such as service connectivity, metrics and logging. Therefore I would like to say a special thanks for Peter Bourgon (@peterbourgon) and all the contributors for providing this awesome libraries.


Use Case

My focus in this article is exposing REST endpoint as a service. The service itself will expose the endpoint with HTTP POST method. And then it will return lorem ipsum message within JSON format.

The endpoint URL format will be /lorem/{type}/{min}/{max}, with several descriptions:

  1. type will be a lorem type, which are word, sentence and paragraph.
  2. min and max will be at least minimum letters and at most maximum letters for generator.

Note: I assume your GOPATH already set in the environment variables


Before starting the step-by-step, there are several libraries which are needed for this examples. Those are:

  1. go-kit libraries.
  2. golorem libraries: for generating lorem ipsum text
  3. gorilla mux libraries: for http handler

Step 1: Building the Service

For whatever coolest tools you have, you need to create business logic at a first time. Our business logic is, as stated in the use case, to create lorem ipsum text, based on word, sentence or paragraph. So let’s create lorem folder under your workspace. In my case, my folder is $GOPATH/github.com/ru-rocker/gokit-playground/lorem. Then create file service.go under the folder and add the following code:

Now we have already the interface. However, interface means nothing without methods implementation. To service.go, add following implementations:

Notice that I am using golorem functions for each method implementations. 

Step 2: Modeling Request and Response

Because this service is part of HTTP, therefore the next step is modeling request and response. If you look back to the Use Case, you will find there are three properties required for the implementation. Those are type, min and max.

And for the response itself, we only need two fields. Those fields are message that contains lorem ipsum text. The other one is error field, which will give error description whenever there is an error. So, let’s create another file, and give it a name endpoints.go and add the following code:

Step 3: Creating Endpoints

Endpoint is a special function in go-kit because you can wrap it into http.Handler. In order to make our service function turns into endpoint.Endpoint function, we are going to make a function to handle the LoremRequest, do some logic inside, then return the LoremResponse. To endpoints.go, add following code:

Step 4: Transport

Before handling the http request and response, at first we need to create encoder and decoder from struct to json or the other way around. For this purpose, create new file, give it a name transport.go and add following code:

Once you already declare the encoder and decoder  functions, then it is time to create the http handler. To transport.go, add following code:

Note: take a look at line 15. It is the way to describe the URL path and HTTP request method.

Step 5: Main

So far we already have service/business layer, endpoint and transport for our services. After all set, it is time to create the main function. The main function basically structure the endpoint and make it available into HTTP transport.

So, under the lorem folder, create another folder, named it lorem.d. The dot d means daemon. You can name it as you like it. I prefer this one. Then create file main.go, and add following code:

Step 6: Run the Example

It is time to run the example. Open your shell and type:

Test the endpoint by using curl or postman. And you will see similar results:

Screen Shot 2017-02-17 at 2.45.35 PM
Sample lorem services

Sample Code

That’s it. Whenever you have any interest about this article and willing to know more, you can check on my github.

See ya.

Author: ru rocker

I have been a professional software developer since 2004. Java, Python, NodeJS, and Go-lang are my favorite programming languages. I also have an interest in DevOps. I hold professional certifications: SCJP, SCWCD, PSM 1, AWS Solution Architect Associate, and AWS Solution Architect Professional.

Leave a Reply

Your email address will not be published. Required fields are marked *