API de encurtador de links: como automatizar URLs curtas

API

AutomaçãoIntegraçõesCotas
Notebook mostra a documentação da API e um exemplo de criação de link, com o título Como usar a API de links.

Criar links pelo painel funciona bem com pouco volume. Quando a geração de URLs faz parte de um sistema, de uma automação de marketing ou de uma rotina recorrente, uma API de encurtador de links cria os links sem trabalho manual.

O que é uma API de encurtador de links?

É a forma de outro software usar o encurtador sem passar pela tela do painel. Em vez de uma pessoa:

  1. abrir o site;
  2. colar uma URL;
  3. clicar em criar;
  4. copiar o resultado;

o sistema envia a URL e recebe o link curto na resposta.

Onde uma API de links pode ser usada?

Sistemas internos

O sistema gera um link curto sempre que um registro, documento ou campanha é criado.

CRM

O CRM cria URLs para oportunidades, comunicações ou materiais enviados aos clientes.

Automação de marketing

A ferramenta de automação gera os links enquanto a campanha é montada.

Outros produtos digitais

Outro produto oferece encurtamento de links dentro das próprias telas.

Scripts e integrações

Rotinas em PHP, JavaScript, Python ou outras linguagens chamam a API para criar e consultar links.

O que a API do pqno.app oferece

  • Criar, obter, listar, editar e excluir links.
  • Consultar estatísticas de um link por período.
  • Consultar o resumo da conta ou da empresa.
  • Gerar uma imagem de QR Code em PNG ou SVG.

São oito endpoints. A geração de imagem não salva um QR Code no painel. Métodos, parâmetros, respostas e exemplos estão na documentação da API.

Exemplo de criação com cURL

Defina PQNO_TOKEN no ambiente do servidor e envie um objeto JSON:

curl -sS -X POST "https://pqno.app/admin/api/encurtar-link/criarlink" \
  -H "Authorization: Bearer $PQNO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/catalogo","titulo":"Catálogo de demonstração"}'

Uma criação bem-sucedida responde HTTP 201. Salve dados.id e dados.url_curta da resposta para usar nas consultas seguintes. O código é automático quando codigo não é enviado. Confira o exemplo completo de resposta.

Código personalizado via automação

Nos planos com código personalizado, a integração pode pedir um código ligado ao próprio registro:

pedido-9182
evento-2026
material-cliente

O código precisa estar livre e seguir as regras do serviço.

Autenticação

Gere um token JWT na área API do painel e envie-o no cabeçalho Authorization: Bearer TOKEN. O token é mostrado uma vez; guarde-o no backend. Não coloque essa credencial em JavaScript público nem na imagem de uma requisição.

O token pessoal do Pro acessa os links de quem o emitiu. No Business, um administrador pode emitir o token da empresa, que gerencia links de toda a organização. Novos links ficam atribuídos a quem emitiu o token. A opção de gerar QR Code por link_id ou perfil continua limitada ao emissor; para outro link da empresa, envie sua URL curta em conteudo.

Limites de API por plano

As cotas padrão são 1.000 requisições de gestão por dia no Pro e 10.000 no Business. No Business, a cota é compartilhada pela empresa, não multiplicada pela quantidade de tokens. Há também limite por minuto.

Confira os cabeçalhos de limite na resposta. HTTP 429 pode indicar limite diário ou por minuto; aguarde o tempo informado em Retry-After. Trate também 401 para token inválido ou expirado, 403 para acesso indisponível e 409 para código em uso. O guia de limites detalha a contagem.

API para pessoa ou empresa?

O Pro é individual e o Business cobre até 10 acessos da organização. A integração deve usar o escopo correto do token: pessoal para links de uma pessoa, empresarial para gerenciar os links da organização. Uma conta Business, por si só, não transforma todo token pessoal em token da empresa.

Quando vale usar API em vez do painel?

Use o painel quando o processo é manual e ocasional. Use a API quando:

  • os links são gerados em grande volume;
  • a criação faz parte de outro sistema;
  • existe uma automação;
  • os links precisam ficar ligados a registros;
  • você quer consultar os dados por código;
  • o processo não pode depender de alguém clicar.

Automatize a criação de links

A API está nos planos Pro e Business, com token gerado no painel.

Ver planos com acesso à API

Revisado em 4 de outubro de 2026. Capa ilustrativa com telas do produto e dados simulados.

Para planejar fluxos de campanha, CRM e relatórios, veja 7 automações de marketing com uma API de links.

Leia também