Descubra como integrar nossa API gratuitamente! 🚀
Pit Pranks

Nossa API de encurtamento de URLs é simples, rápida e gratuita! Com apenas algumas linhas de código, você pode integrá-la ao seu projeto e começar a gerar links curtos personalizados em segundos.

  1. Fácil de integrar - Exemplos prontos para você copiar e usar.
  2. Gratuita - Nenhum custo para começar.
  3. Rápida e segura – Links encurtados instantaneamente.

📖 Confira a documentação oficial e descubra como é simples integrar nossa API. ✨ Novidade: Agora você também pode acompanhar a quantidade de cliques na sua URL ao compartilhá-la — e o melhor, totalmente grátis!

Comece agora!

Antes de começar, você precisa gerar uma chave de API no painel de gerenciamento. Você pode clicar aqui para ser direcionado para a página. Após isso, siga os passos abaixo:

  1. Crie sua chave de API. Basta clicar em gerar chave e aguardar.
  2. Copie sua KEY. Após gerar a chave, basta clicar em cima para copiar a KEY.
  3. Acompanhe suas requisições. Você pode acompanhar suas requisições diretamente no painel.

📌 Introdução

A API do Slnk.bio permite encurtar URLs de forma rápida e segura, utilizando requisições HTTP nos métodos POST e GET. Este documento fornece detalhes sobre a implementação.

Método POST

🔧 Implementação do Formulário

O exemplo abaixo demonstra como criar um formulário HTML para enviar uma URL e obter o link encurtado via POST.

<form id="urlForm" method="POST" action="https://slnk.bio/api.php">
  <input type="text" name="url" id="url" placeholder="URL completa" required />
  <input type="text" name="api_key" id="api_key" placeholder="Chave da API" required />
  <button type="submit">Encurtar</button>
</form>
<div id="result"></div>

🔑 Adicionando a Chave API Padrão

Para tornar o uso da API mais dinâmico, você pode definir uma chave padrão no formulário, conforme o exemplo abaixo:

<input type=" hidden" name=" api_key" id="api_key" required value="jbhaisnkaksm5544a6s6as64aa66"/>

Nota: O campo de entrada está definido como hidden, tornando a experiência mais intuitiva para o usuário.

🛠️ Configuração JavaScript

Para evitar conflitos, o script deve ser carregado no head com o atributo defer ou inserido no final do body.

<script src="https://slnk.bio/api/assets/scripts/v1/post/snlk.bio.js"></script>

Método GET

🔍 Estrutura da Requisição

GET https://slnk.bio/api.php?url={URL}&api_key={CHAVE_API}

🖥️ Exemplo com cURL

curl "https://slnk.bio/api.php?url=https://exemplo.com&api_key=sua_chave_aqui"

🔧 Implementação do Formulário

O exemplo abaixo demonstra como criar um formulário HTML para enviar uma URL e obter o link encurtado via GET.

<form id="urlForm" method="GET" action="https://slnk.bio/api.php">
  <input type="text" name="url" id="url" placeholder="URL completa" required />
  <input type="text" name="api_key" id="api_key" placeholder="Chave da API" required />
  <button type="submit">Encurtar</button>
</form>
<div id="result"></div>

🔑 Adicionando a Chave API Padrão

Para tornar o uso da API mais dinâmico, você pode definir uma chave padrão no formulário, conforme o exemplo abaixo:

<input type=" hidden" name=" api_key" id="api_key" required value="jbhaisnkaksm5544a6s6as64aa66"/>

Nota: O campo de entrada está definido como hidden, tornando a experiência mais intuitiva para o usuário.

🛠️ Configuração JavaScript

Para evitar conflitos, o script deve ser carregado no head com o atributo defer ou inserido no final do body.

<script src="https://slnk.bio/api/assets/scripts/v1/get/snlk.bio.js"></script>

📩 Modelo de Resposta

✅ Sucesso

{
  "success": "URL encurtada com sucesso",
  "shortenedUrl": "slnk.bio/is/abc123"
}

❌ Erro

{
  "error": "Chave de API inválida"
}

Referência de Códigos

Veja mais alguns erros comuns.

Código Descrição Solução
400 Parâmetros ausentes Verificar parâmetros obrigatórios
401 Chave API inválida Validar chave no painel administrativo
429 Limite de requisições excedido Aguardar renovação do ciclo

Considerações Técnicas

  1. Todas as requisições devem utilizar HTTPS
  2. Encoding: UTF-8 obrigatório
  3. Formato de resposta: JSON
  4. Timeout: 15 segundos por requisição
  5. Logs de acesso: Disponíveis no painel administrativo