Comece por aqui

Use a API do pqno.app para criar e gerenciar links curtos, consultar cliques e gerar QR Codes no seu sistema. O acesso está disponível nos planos Pro e Business.

Configure o acesso

1. Entre no painel do pqno.app e abra API.
2. Em Gerar token, selecione Links e informe um identificador, como “Site da loja”.
3. Escolha a validade, de 24 horas a 1 ano, e gere o token.
4. Copie o token e guarde-o no servidor, na variável de ambiente PQNO_TOKEN. Ele é exibido apenas uma vez.

No Business, o token da empresa deve ser gerado por um administrador. Consulte Autenticação para entender o acesso de cada plano e como substituir ou revogar tokens.

Endereço base

https://pqno.app/admin/api

Acrescente o caminho do endpoint a esse endereço. Por exemplo, a criação de links usa /encurtar-link/criarlink. Em produção, envie as requisições por HTTPS.

Crie seu primeiro link

Com PQNO_TOKEN configurada, execute este exemplo com cURL:

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://exemplo.com.br/oferta"}'

Uma criação bem-sucedida retorna HTTP 201. No JSON, dados.url_curta é o endereço para compartilhar e dados.id identifica o link nas próximas requisições. Veja os campos e exemplos completos em Criar link.

Escolha a próxima operação

• Obter link consulta um link pelo ID ou código.
• Listar links pesquisa os links e retorna os resultados em páginas.
• Editar link altera o destino, o código, o título ou a descrição.
• Excluir link remove um link e seus dados de cliques.
• Estatísticas de um link consulta os cliques por dia.
• Resumo da conta reúne os números da conta e o consumo da API.
• Gerar QR Code retorna uma imagem PNG ou SVG.

Prepare a integração para produção

Implemente o tratamento de respostas e erros e acompanhe os limites de uso. Os guias de paginação e filtros e de como salvar a imagem de um QR Code mostram operações completas.

Os IDs e as URLs dos exemplos são ilustrativos. Substitua-os pelos valores da sua conta.