Encurtador de links

Obter link

Consulte um link pelo ID ou código, incluindo cliques e disponibilidade do destino.

GEThttps://pqno.app/admin/api/encurtar-link/obterlink

Consulta um link e retorna seus dados, os cliques do mês, o total acumulado e a disponibilidade do destino.

Identifique o link

Envie id ou codigo na URL da requisição. Use apenas um deles:

id: identificador retornado ao criar ou listar links.
codigo: trecho depois da barra no endereço curto. Em https://pqno.app/promo-outubro, o código é promo-outubro.

Enviar os dois parâmetros, ou omitir ambos, retorna HTTP 400. Com token pessoal, a consulta se limita aos links de quem o gerou; com token da empresa, inclui os links das pessoas dessa empresa. Um link fora desse acesso retorna 404.

Dados retornados

Além dos campos descritos em Criar link, dados inclui:

Campo	Descrição
`cliques_no_mes`	Cliques registrados no mês corrente.
`total_cliques`	Total de cliques registrados desde a criação.
`destino_fora_do_ar`	Indica se a última verificação classificou o destino como indisponível.
`fora_do_ar_desde`	Data e horário do início da indisponibilidade registrada, ou `null` quando não há registro.

Disponibilidade do destino

O pqno.app verifica os destinos periodicamente e após acessos aos links. Esses campos mostram o estado registrado pelas verificações, e não uma consulta em tempo real feita por esta requisição.

Ao trocar o destino com Editar link, uma nova verificação é agendada. Consulte novamente depois que ela for executada para acompanhar a situação do novo endereço.

Parâmetros

Cabeçalho

Authorizationtextoobrigatório: Envie Bearer seguido do token da API, como Authorization: Bearer SEU_TOKEN.

Parâmetros de consulta

idinteiro: ID do link. Envie id ou codigo, nunca os dois.
codigotexto: Código do endereço curto, sem domínio ou barra. Envie codigo ou id, nunca os dois.

Exemplo de requisição

curl -sS "https://pqno.app/admin/api/encurtar-link/obterlink?codigo=promo-outubro" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const resposta = await fetch('https://pqno.app/admin/api/encurtar-link/obterlink?id=4821', {
  headers: { 'Authorization': `Bearer ${process.env.PQNO_TOKEN}` }
});
const json = await resposta.json();
if (json.status !== 'ok') throw new Error(json.mensagem);
if (json.dados.destino_fora_do_ar) console.log('Destino fora do ar desde', json.dados.fora_do_ar_desde);
console.log(json.dados.url, json.dados.total_cliques);

<?php
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/obterlink?' . http_build_query(['codigo' => 'promo-outubro']));
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('PQNO_TOKEN')],
]);
$json = json_decode(curl_exec($ch), true);
if (($json['status'] ?? '') !== 'ok') {
    throw new RuntimeException($json['mensagem'] ?? '');
}
echo $json['dados']['url'], ' ', $json['dados']['total_cliques'], PHP_EOL;

import os
import requests

resposta = requests.get(
    'https://pqno.app/admin/api/encurtar-link/obterlink',
    headers={'Authorization': f"Bearer {os.environ['PQNO_TOKEN']}"},
    params={'id': 4821},
    timeout=30,
)
corpo = resposta.json()
if corpo['status'] != 'ok':
    raise RuntimeError(corpo['mensagem'])
print(corpo['dados']['url'], corpo['dados']['total_cliques'])

Respostas

Dados do link, contagens de cliques e disponibilidade registrada do destino.

{
  "status": "ok",
  "dados": {
    "id": 4821,
    "codigo": "promo-outubro",
    "url_curta": "https://pqno.app/promo-outubro",
    "url": "https://exemplo.com.br/campanha?utm_source=email",
    "titulo": "Campanha de outubro",
    "descricao": "",
    "criado_em": "2026-10-03T14:32:10-03:00",
    "criado_por": { "id": 37, "nome": "Marina Souza" },
    "expira_em": "2026-12-31T23:59:00-03:00",
    "max_cliques": 5000,
    "cliques_contados": 1742,
    "com_senha": false,
    "etiquetas": ["campanha", "email"],
    "pixels": { "meta": "123456789012345" },
    "cliques_no_mes": 318,
    "total_cliques": 1742,
    "destino_fora_do_ar": false,
    "fora_do_ar_desde": null
  }
}

Informe apenas id ou codigo. Parâmetros desconhecidos ou inválidos são recusados.

{
  "status": "erro",
  "mensagem": "Informe o id ou o codigo do link, um dos dois."
}

Link inexistente ou fora do acesso do token.

{
  "status": "erro",
  "mensagem": "Link não encontrado."
}

Cota diária ou limite por minuto atingido. Aguarde o tempo informado em Retry-After.

{
  "status": "erro",
  "mensagem": "Cota diária de API atingida (1000/dia). Tente novamente amanhã."
}