Documentação da API - Linka.rio

Documentação da API

Encurtamento de URLs de forma rápida, prática e segura

1 Sobre a API

A API do Linka.rio é um serviço simples para encurtar URLs. Basta enviar uma requisição GET com o link que deseja encurtar, e nossa API retornará um link curto para você compartilhar.

A API foi desenvolvida com foco na rapidez e praticidade, garantindo que você obtenha uma resposta em formato JSON.

2 Como Utilizar

Para utilizar a API, basta acessar a seguinte URL, substituindo https://site.com pelo endereço desejado:

https://linka.rio/api/https://site.com

A requisição deve ser feita via GET. Certifique-se de que o URL informado seja válido (deve conter http:// ou https://).

3 Exemplo de Requisição

Você pode testar a API utilizando, por exemplo, o comando curl:

curl https://linka.rio/api/https://site.com

A resposta será algo como:

{
  "link": "https://linka.rio/abcd1234"
}

4 Resposta da API

A API retorna uma resposta em JSON com a seguinte estrutura:

  • link: a URL encurtada gerada pelo serviço

Caso haja algum erro (por exemplo, se o URL não for válido), a API retornará um erro com o código HTTP correspondente e uma mensagem explicativa.

5 Limitações e Segurança

Para evitar abusos, nossa API aplica uma limitação de 100 requisições por minuto por IP. Se você exceder esse limite, receberá uma resposta com o código 429 Too Many Requests.

Além disso, todas as requisições devem ser feitas utilizando URLs válidas.

6 Suporte e Contato

Em caso de dúvidas ou problemas com a API, entre em contato conosco pelo e-mail: fale@linka.rio.

Estamos sempre abertos a feedbacks e sugestões para melhorar nossos serviços.

Última atualização: Janeiro de 2025