← Voltar

Documentação da API Curtin

Visão Geral

A API Curtin permite que os desenvolvedores criem e recuperem URLs encurtadas de forma programática. Esta API foi projetada para ser simples, consistente e eficiente para uso em várias aplicações.

URL Base

https://curtin.com.br/

Autenticação

A versão atual da API não requer uma chave de API para uso geral.

Endpoints

1. Criar uma URL Encurtada

Endpoint: /json/{url}
Método: GET
Descrição: Cria uma URL encurtada para a URL completa fornecida.

Parâmetros da Requisição

Exemplo de Requisição

GET /json/https%3A%2F%2Fgratis.com.br HTTP/1.1
Host: curtin.com.br

Exemplo de Resposta

{
    "short_url": "https://curtin.com.br/Xyz123"
}

Exemplo em Python

import requests

url_to_shorten = "https://gratis.com.br"
response = requests.get(f"https://curtin.com.br/json/{requests.utils.quote(url_to_shorten)}")

if response.status_code == 200:
    data = response.json()
    print("URL encurtada:", data["short_url"])
else:
    print("Erro ao encurtar a URL:", response.status_code, response.text)

Exemplo em JavaScript

async function encurtarUrl() {
    const url = 'https://gratis.com.br';
    try {
        const response = await fetch(`https://curtin.com.br/json/${encodeURIComponent(url)}`);
        const data = await response.json();
        if (data.short_url) {
            console.log('URL encurtada:', data.short_url);
        } else {
            console.error('Erro:', data);
        }
    } catch (error) {
        console.error('Erro ao encurtar a URL:', error);
    }
}

encurtarUrl();

Códigos de Resposta

2. Redirecionar para a URL Completa

Endpoint: /{short_url}
Método: GET
Descrição: Redireciona o usuário para a URL completa associada à URL encurtada fornecida.

Exemplo de Requisição

GET /Xyz123 HTTP/1.1
Host: curtin.com.br

3. Ver Estatísticas da URL

Endpoint: /stats/{short_url}
Método: GET
Descrição: Recupera estatísticas de uma URL encurtada, como número de cliques, dados de user agent, e mais.

Exemplo de Requisição

GET /stats/Xyz123 HTTP/1.1
Host: curtin.com.br

Exemplo de Resposta

{
    "short_url": "https://curtin.com.br/Xyz123",
    "full_url": "https://gratis.com.br",
    "clicks": 150,
    "created_at": "2024-11-01T12:00:00Z",
    "last_accessed": "2024-11-03T08:45:00Z"
}

Melhores Práticas

Erros Comuns