Skip to content

robvanbakel/gotiny-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GoTiny is no longer available

Read more: GoTiny is shutting down


GoTiny API

GoTiny is a link shortener API that's built with a failproof user experience as its main goal, for both the visitors of the landing page as well as developers. GoTiny links are all lowercase and don't include characters that could be confused with each other (e.g. o/0 or 1/i/l).

It also filters the url out of any string that a user enters. This way, developers using the API don't have to provide a clean link, but can just feed an entire paragraph into GoTiny. The API will find the url and return a short link.

Table of Contents

Usage

Create GoTiny link

The GoTiny API lets you quickly obtain a short code that's used to redirect to an URL specified by the user.

Method Endpoint Format Parameters
POST https://gotiny.cc/api JSON input, {long,custom,useFallback}

To use the GoTiny API, make a POST request to the endpoint https://gotiny.cc/api. The body of your request should be in JSON format with a property name of input. This key should have a value of the URL you want to shorten or a string that contains that URL. When multiple URLs are found in the provided string, short links will be generated for all of them.

The response will be formatted as JSON and contain the long URL that was shortened and a randomly generated 6-character long code, if provided. This code will be used as an identifier to redirect to the long URL.

Example Request

curl
curl -X POST https://gotiny.cc/api -H "Content-Type: application/json" -d '{ "input" : "https://amazon.com/very-long-url" }'
JavaScript
fetch("https://gotiny.cc/api", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ input: "https://amazon.com/very-long-url" }),
})

Example Response

{
  "long": "https://amazon.com/very-long-url",
  "code": "y68hxc"
}

When gotiny.cc/y68hxc is visited, the visitor will be redirected to https://amazon.com/very-long-url.

Options

Options are provided by sending an object in the request body. The object should have a long key with the long link as a value, as wel as any of the supported options. Options currently supported are:

Key Type Description
custom string Generates a custom link (e.g. gotiny.cc/custom-link). Custom codes should consist of 4-32 lowercase letters, numbers, - and/or _ symbols.
useFallback boolean Set to false if you don't want to use a randomly generated 6-character fallback code and throw an error instead when a custom code can't be used.

To generate multiple links at once, you can pass an array of objects into the request body.

Example Request

curl
curl -X POST https://gotiny.cc/api -H "Content-Type: application/json" -d '{ "long": "https://amazon.com/very-long-url", "custom": "amazon", "useFallback": false }'

Resolve GoTiny link

You can get the long URL that corresponds with a GoTiny link by making a GET request to https://gotiny.cc/api/<code>. The long URL will be returned in plain text.

Example Request

curl
curl https://gotiny.cc/api/y68hxc
JavaScript
fetch('https://gotiny.cc/api/y68hxc')
  .then((res) => res.text())
  .then((data) => console.log(data))

You can add the query parameter ?format=json to this call to be returned the full link as a JSON formatted object.

JavaScript SDK

JavaScript developers might want to consider using the GoTiny SDK. The SDK provides extra features like improved error-handling and extended return objects.

Built With

Other repositories

About

A lightweight link shortener API

Resources

Stars

Watchers

Forks