Criar link

Cria um link curto para o endereço informado em url. Use HTTP POST, envie um objeto JSON e inclua Content-Type: application/json.

Informe o destino

url é obrigatório e aceita um endereço HTTP ou HTTPS de até 2.048 caracteres, incluindo parâmetros de campanha. Se o protocolo for omitido, o pqno.app acrescenta https://.

Use titulo e descricao para identificar o link no painel. Esses campos são opcionais e aceitam até 255 e 500 caracteres, respectivamente.

Escolha o código do link

Omitir codigo gera um código aleatório. Para personalizá-lo, envie de 3 a 50 caracteres: letras minúsculas, números, hífen ou sublinhado. O primeiro e o último caractere devem ser uma letra ou um número.

Um código já utilizado ou reservado pelo site retorna HTTP 409. Escolha outro código e repita a requisição.

Defina regras de acesso

Três campos opcionais controlam o acesso ao destino. Cada um aceita null, equivalente a omitir o campo.

Campo	Descrição
expira_em	Data e hora futuras em ISO 8601 com fuso, como 2026-12-31T23:59:00-03:00. Depois desse instante, o endereço curto responde HTTP 410 e não abre o destino.
max_cliques	Inteiro de 1 a 1.000.000.000. Quando os cliques contados chegam ao limite, o endereço curto responde HTTP 410. A contagem começa em zero e não inclui robôs nem pré-carregamentos do navegador.
senha	De 4 a 64 caracteres. Uma página pede a senha antes de abrir o destino, com até 10 tentativas a cada 15 minutos. A senha é guardada só como hash e nunca volta na resposta.

Etiquetas

O campo opcional etiquetas recebe uma lista de textos, como ["campanha", "instagram"]. Cada link aceita até 10 etiquetas de até 30 caracteres cada. Maiúsculas e minúsculas contam como a mesma etiqueta. Repetições são descartadas. null equivale a omitir o campo.

Pixels de acompanhamento

O campo opcional pixels recebe um objeto com os IDs dos serviços meta, google, tiktok e linkedin. Quem abre o link num navegador passa por uma página breve que avisa sobre a medição e carrega os serviços antes de seguir para o destino. Robôs, prévias de redes sociais e clientes HTTP que pedem outros formatos recebem o redirecionamento direto.

Serviço	Formato do ID
meta	De 8 a 20 dígitos.
google	G-, AW- ou GT- seguido de 4 a 20 letras ou números, como G-ABC123DEF4.
tiktok	De 10 a 30 letras maiúsculas ou números.
linkedin	De 4 a 12 dígitos.

Pixels exigem plano Pro ou Business e permissão da instalação. Enviar um pixel com outro plano ou com a opção desligada retorna HTTP 403. null no lugar do objeto equivale a omitir o campo.

Resultado da criação

HTTP 201 confirma a criação. O objeto dados contém:

Campo	Descrição
id	Identificador do link para consultas e alterações.
codigo	Código que aparece depois da barra no endereço curto.
url_curta	Endereço curto completo para compartilhar.
url	Endereço de destino do link.
titulo / descricao	Título e descrição cadastrados para o link.
criado_em	Data e horário de criação, com o fuso informado.
criado_por	Objeto com o ID e o nome de quem criou o link.
expira_em	Instante de expiração com fuso, ou null quando o link não expira.
max_cliques	Limite de cliques, ou null quando não há limite.
cliques_contados	Cliques contados para o limite.
com_senha	true quando o link pede senha.
etiquetas	Etiquetas do link em ordem alfabética.
pixels	Objeto com os IDs dos serviços configurados, ou {} quando vazio.

Guarde id para consultar, editar, excluir ou consultar as estatísticas do link. Com token da empresa, criado_por identifica o administrador que gerou o token.

Evite criação duplicada

Cada requisição bem-sucedida cria um novo link, mesmo que o destino já exista. Se a conexão cair antes da resposta, pesquise o destino em Listar links com busca antes de reenviar.