Exclusivo Premium

API do VerLink

Crie, liste e acompanhe seus links curtos programaticamente. Ideal pra integrar o encurtador direto no seu sistema, planilha ou automação.

Início Rápido

Gere sua chave

No seu painel, seção "API para Desenvolvedores" (conta Premium).

Faça a requisição

Envie a chave no cabeçalho Authorization.

Pronto!

Seu link curto já existe e já pode ser compartilhado.

terminal

# Cria um link curto e já recebe o link pronto de volta
curl -X POST https://verlink.co/api/v1/links-criar.php \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"url_destino": "https://exemplo.com", "titulo": "Meu link"}'

Autenticação

Toda requisição precisa da sua chave, enviada no cabeçalho:

cabeçalho HTTP

Authorization: Bearer SUA_CHAVE_AQUI

Sem essa chave (ou com uma chave inválida/revogada), toda requisição retorna 401.

Limite de uso

Máximo de 60 requisições por minuto, por chave. Se passar disso, você recebe 429 — espera um pouco e tenta de novo.

Endpoints

POST /api/v1/links-criar.php

Cria um novo link curto.

Corpo (JSON):

json

{
  "url_destino": "https://exemplo.com/pagina-longa",
  "titulo": "Opcional",
  "slug": "opcional-personalizado"
}

Exemplo com curl:

terminal

curl -X POST https://verlink.co/api/v1/links-criar.php \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"url_destino": "https://exemplo.com", "titulo": "Meu link"}'

Resposta 201:

json

{
  "slug": "aB3xY9",
  "url_curta": "https://verlink.co/r/aB3xY9",
  "url_destino": "https://exemplo.com",
  "titulo": "Meu link"
}

GET /api/v1/links-listar.php

Lista seus links curtos, mais recentes primeiro. Parâmetros opcionais: pagina (padrão 1) e por_pagina (padrão 20, máx 100).

terminal

curl https://verlink.co/api/v1/links-listar.php?pagina=1 \
  -H "Authorization: Bearer SUA_CHAVE"

GET /api/v1/links-estatisticas.php?slug=xxxxxx

Retorna os detalhes e o total de cliques de um link específico.

terminal

curl "https://verlink.co/api/v1/links-estatisticas.php?slug=aB3xY9" \
  -H "Authorization: Bearer SUA_CHAVE"

POST /api/v1/links-excluir.php

Exclui um link curto seu.

terminal

curl -X POST https://verlink.co/api/v1/links-excluir.php \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"slug": "aB3xY9"}'

Códigos de erro

400 — Requisição inválida (faltou campo obrigatório, formato errado)
401 — Chave de API ausente ou inválida
403 — Plano Premium expirado
404 — Link não encontrado
409 — Slug já está em uso
429 — Limite de requisições atingido

Gerar minha chave de API

Prefere um passo a passo com prints? Leia o tutorial no blog.