concierge

README

Concierge

A tiny URL shortener written in Go.

I've been exploring Go with the intention of using it to build microservices; this is a learning project to understand Go code structure, the Echo web framework, and GORM (a PostgreSQL ORM).

Concierge ("one who keeps the entrance to an edifice") is a JSON-based REST API which takes a valid alias and returns the corresponding URL via a HTTP 301 redirect. There's also a management endpoint to create (or preview existing) records. Once records are created they can't be removed or modified via the API.

API Specification

/ - Root

• GET
  Returns documentation about the API and its endpoints.

/to/:alias - Link Redirection

• GET - Requires an alias URL parameter.
  Share links to this endpoint with your target audience.
  Returns a redirection HTTP 301 response to the corresponding URL of the supplied alias. All redirections are prefixed with https:// automatically for security reasons.

/link/:alias - Link Management

• GET - Requires an alias URL parameter.
  Returns metadata about an existing entry matching the alias, its creation date, and the corresponding URL.

• POST - Requires an alias URL parameter and a url query parameter.
  If the alias is vacant, a new unique record will be created for the provided url.

Deployment Instructions

Setup

Concierge can be run as a Docker container and uses port 3000. The latest release image of abiddiscombe/concierge can be pulled from Docker Hub.

Concierge uses PostgreSQL to persist data. The following environment variables are required to connect to a PostgreSQL server:

• CONCIERGE_PG_HOST - DB URL
• CONCIERGE_PG_PORT - DB Port
• CONCIERGE_PG_NAME - DB Name
• CONCIERGE_PG_USER - DB User
• CONCIERGE_PG_PASS - DB Password

Logging

Concierge uses the log/slog package to print structured logs. These can be captured and ingested by a supported third-party syslog service.