Links curtos por requisição HTTP
Crie links dinâmicos e consulte destino, status e cliques em JSON. O mesmo domínio curto e as mesmas proteções usadas no painel.
Disponível em todos os planos. O gratuito inclui 10 chamadas por dia.
O que você não precisa resolver
O mesmo motor do painel
Links criados pela API aparecem no mesmo workspace, seguem o mesmo limite do plano e podem ser administrados no painel.
Validação junto
O destino é normalizado e passa por bloqueio de protocolos perigosos, redes internas e redirecionadores suspeitos.
Resposta previsível
Toda resposta é JSON, com códigos HTTP explícitos e cabeçalhos de limite e consumo para sua integração reagir corretamente.
Destino editável
O endereço curto permanece igual enquanto você ajusta o destino e as regras pelo painel.
Onde isso costuma entrar
Casos em que criar e acompanhar links manualmente não escala.
E-commerce e logística
Um link curto por campanha, produto ou pedido, com destino alterável sem trocar o endereço divulgado.
Ingressos e credenciais
Um link por evento ou participante, criado junto com o fluxo de inscrição e medido separadamente.
Cardápio e mesas
Links por unidade, mesa ou canal, permitindo trocar o cardápio e comparar os acessos.
Campanhas financeiras
Distribua destinos de pagamento ou atendimento com rastreamento e regras sem expor a URL final.
Produto com Link embutido
Convites, compartilhamentos e atalhos por usuário, gerados sob demanda e administrados no mesmo workspace.
Mídia física em escala
Use o endereço curto em peças impressas e atualize o destino depois, sem reimprimir o material.
Três passos
Crie a chave
No Console de desenvolvedores. Ela aparece uma vez só e fica guardada com hash — nem nós conseguimos recuperá-la depois.
Chame o endpoint
POST cria um link e GET consulta pelo código. Sempre do seu servidor: chave em navegador é chave pública.
Use o link curto
Publique shortUrl e use o identificador ou código retornado para conectar sua automação ao painel.
Consultar pelo código
curl -H "Authorization: Bearer lnk_suachave" \
"https://app.links.kadu.pro/api/v1/link?code=Ab3dE7x"Criar um link
curl -X POST https://app.links.kadu.pro/api/v1/link \
-H "Authorization: Bearer lnk_suachave" \
-H "Content-Type: application/json" \
-d '{
"targetUrl": "https://exemplo.com/oferta",
"name": "Campanha de agosto"
}'A resposta
A criação devolve o código, a URL curta, o destino normalizado, o status e os identificadores necessários para sua integração.
{
"id": "4dcdfb9c-…",
"shortCode": "Ab3dE7x",
"shortUrl": "https://app.links.kadu.pro/r/Ab3dE7x",
"targetUrl": "https://exemplo.com/oferta",
"name": "Campanha de agosto",
"status": "active",
"createdAt": "2026-08-04T12:00:00Z"
}O que a API aceita
| Recurso | Detalhe |
|---|---|
| Criar | POST com targetUrl obrigatório e name opcional. Retorna 201 com o link criado. |
| Consultar | GET com code na query. Só retorna links pertencentes ao workspace da chave. |
| Resposta | JSON com id, shortCode, shortUrl, targetUrl, name, status, cliques e datas. |
| Payload | Até 16 KB. O nome é limpo e limitado a 80 caracteres. |
| Segurança de destino | A mesma checagem do editor: sem esquema estranho, sem credencial na URL, sem IP literal, sem host interno. |
| Limite | Header X-RateLimit-Limit em toda resposta. Estourou, vem 429 com o teto informado. |
Limites e preço
O limite é por chave, e por minuto.
| Plano | Por minuto | Observação |
|---|---|---|
| Free | 10/min · 10 por dia · 30 por mês | Ideal para experimentar e prototipar. |
| Pro | 60 | Para produto em operação. |
| Business | 300 | Para volume e times. |
Acima da franquia do plano, o excedente sai por mil chamadas. US$ 2 / 1.000. Com teto de gasto padrão, para uma integração com defeito não virar fatura surpresa. US$ 50.
Ver planosSobre a chave
Guardada com hash
Mostrada uma vez na criação. Perdeu, revogue e gere outra — recuperar não é possível, de propósito.
Revogação imediata
Revogou, a chave para de valer na chamada seguinte. Uma chave por integração faz derrubar uma não derrubar as outras.
Só do servidor
Chave em JavaScript de navegador, app mobile ou repositório público é chave pública. Guarde em variável de ambiente.
Sem cache compartilhado
As respostas vão com no-store: o conteúdo pode ser de um usuário específico. Se precisar de cache, faça do seu lado.
Comece com uma chave
A referência completa, com todos os parâmetros e códigos de erro, está na documentação. Há também um playground para testar sem escrever código.