Written in Hexagonal Architecture

This is a small API that provides basic REST endpoints to shorten a URL, get information about the URL, update the URL, and get statistics on most accessed URLs.

The technology behind it:



  1. Requests can come from many types of devices.
  2. Cloud Run is a fully managed serverless platform which already has an integrated load balance. See the doc here
  3. Cloud Run will automatically scale to the number of container instances needed to handle all incoming requests. See the doc here
  4. All request to get a URL will be checked in the cache first and any new URL that is generated will cached with a configurable TTL.
  5. All request to get a URL that is not found in the cache will be queried on the NoSQL and any new URL that is generated will be stored on the NoSQL.
  6. For eache redirect request, a message will be sent to a pubsub topic to record that we had one more access.
  7. Here, we have an Apache Beam pipeline running in Dataflow, to group all messages by Id in a fixed time window, that will update the NoSQL database. This is a separate project, see here

Installing / Getting started

Using docker-compose

In the terminal run the following command:

docker-compose up

Access the documentation

After starting the app you can access the documentation and test using the Try it on option.


Running tests

In the terminal run the following command:

go test -coverprofile=coverage.out -v ./...

Show the coverage report on terminal:

go tool cover -func=coverage.out

Open the coverage report in HTML format:

go tool cover -html=coverage.out

Public access via Google Cloud Run


Performance testing using JMeter

20 users making 500 parallel requests during 1min 19sec, total 10,000 requests:


CPU utilization:


Memory utilization:



View Github