goshort

README

GoShort

GoShort is a simple Golang API URL Shortener, started as a learning project it gave me a nice time building the first version, I'll try to update it often with new ideas and functionality, one of the things I wanna do first is use Redis + MySQL to balance the load of the current MySQL database, the second thing I wanna do is restructure the files in order to make it easier to mantain. Hope you people like this and I'm open to new ideas, just remember this is just the server part, the client will be public soon, some tutorial will be public soon on my blog.

Setup

• Install dependencies: go get -u ./...
• Copy .env.example and save it as .env
• Edit .env file with your PORT and DATABASE_URL info
• Install VueJS dependencies: npm install
• Compile frontend: npm run build
• Build: go build
• Run the server: ./goshort

API

Currently has just two basic functions, search the original URL by a given code and store new URL's randomly generating unique codes.

Get the original URL

GET /:code

Returns:

{
    "url": {
        "id": "5",
        "code": "dBA8",
        "original_url": "https://www.example.com/this-is-a-long-url"
    }
}

This code is used to redirect to original URL, if not found shows a 404 Page.

Submit a URL to shorten

POST /api/v1/shorten

Body:

{
    "original_url": "https://www.example.com/lets-see-if-this-works"
}

Returns:

  {
    "url": {
        "code": "pJ7V",
        "original_url": "https://www.example.com/lets-see-if-this-works"
    }
}

TO DO

• Make the redirection in the main route
• Make a delete route
• Make guest and member URL's
• Make a route to fetch all the member URL's
• Social login
• Make GoShort client with VueJS
• Implement Redis to search by code
• Implement visit count
• Implement QR Code
• Visual changes (add brand)
• Implement local storage history to guests
• Implement throttle by IP
• Add LICENSE
• Add CHANGELOG.md
• Add CI/CD to the workflow

Compatibility

The project frontend is built with VueJS, that means ES6 syntax is the standard used, some browsers may not be compliant to this standard yet, thus some issues may arise, we've been notified about a bug happening in iPhone 6s with Safari, following that trace we find the same issue in IE11, we've managed to fix IE11 issue but couldn't reproduce the issue in iPhone 6s yet.

This issue may be found (or not) in browsers not fully compliant with ECMAScript 2015 (ES6), we added babel-polyfill to handle this issue but we cannot guarantee that the problem will not arise again in older browsers.

Thanks to Yan Edy Chota Castillo who first encountered this bug in production!

Changelog

You can see all our realeases in the changelog