Documentação da API

Integre o poder do nosso encurtador em suas aplicações com uma API robusta, segura e fácil de usar.

Sobre a Nossa API

Na SmashSoft, acreditamos em fornecer ferramentas poderosas e acessíveis. Nossa API foi construída sobre o Django REST Framework, uma base sólida e amplamente confiável no mundo do desenvolvimento web. Para garantir a segurança de cada requisição, utilizamos o padrão Simple JWT (JSON Web Tokens), assegurando que sua conexão seja sempre autenticada e protegida.

O resultado é uma API de alta performance, confiável e extremamente segura, pronta para escalar com as suas necessidades.


Autenticação

Para utilizar a API, você precisa de um token de acesso pessoal. Clientes dos nossos planos pagos podem gerar e gerenciar seus tokens diretamente no painel de controle, na seção "Minhas Informações".

O seu access_token deve ser incluído no corpo (body) de cada requisição que você fizer ao nosso endpoint. Trate este token como uma senha; ele é a chave para a sua integração.

Mantenha seu access_token em segurança e nunca o exponha no código do lado do cliente (frontend).


Endpoint: Encurtar Link

Temos um único e poderoso endpoint para criar seus links curtos.

POST https://smashsoft.com.br/v1/api/shortcuts/connect/

Parâmetros do Corpo (Body)

Sua requisição deve ser do tipo application/x-www-form-urlencoded ou multipart/form-data e conter os seguintes campos:

  • original_url (string, obrigatório): A URL completa que você deseja encurtar.
  • access_token (string, obrigatório): Seu token de acesso pessoal.

Resposta de Sucesso (201 Created)

Se a requisição for bem-sucedida, a API retornará um objeto JSON com a URL curta e outros detalhes. A URL final já vem pronta para uso no campo data.url_shortener.url.

{
    "id": 180,
    "original_url": "https://smashsoft.com.br/gedia/voucher/issued/...",
    "short_code": "6fmVi8J4Isf897j",
    "data": {
        "url_site": {
            "name": "smashsoft.com.br/cut/",
            "url": "https://smashsoft.com.br/cut/"
        },
        "url_shortener": {
            "name": "smashsoft.com.br/cut/6fmVi8J4Isf897j/",
            "url": "https://smashsoft.com.br/cut/6fmVi8J4Isf897j/"
        }
    },
    "created_at": "2025-07-13T17:55:32.831768-03:00",
    "generator": 1
}

Respostas de Erro

  • 400 Bad Request: Ocorre se o campo original_url não for fornecido ou for inválido.
  • 401 Unauthorized: Ocorre se o access_token for inválido, expirado ou não fornecido.
  • 429 Too Many Requests: Se você exceder os limites de requisição da API.

Exemplos de Conexão

Selecione sua linguagem preferida e comece a integrar em minutos.