Encurtador de links

Listar links

Liste os links com paginação, busca e filtro por pessoa no token da empresa.

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

Retorna os links acessíveis ao token, ordenados do mais recente para o mais antigo. Cada item inclui os dados do link, seu autor e os cliques do mês corrente.

Paginação e busca

Use pagina para escolher a página, começando em 1, e por_pagina para definir de 1 a 100 itens por requisição. Os valores padrão são página 1 e 20 itens.

busca aceita até 100 caracteres e pesquisa o título, a URL de destino e o código do link, sem diferenciar maiúsculas de minúsculas. A busca e os demais filtros se aplicam também ao total de resultados.

Filtro por pessoa

Com token da empresa, envie usuario para listar apenas os links de uma pessoa. O ID pode ser obtido em criado_por.id ou na lista pessoas de Resumo da conta.

Com token pessoal, os resultados já se limitam a quem gerou o token; enviar usuario retorna HTTP 400.

Filtro por etiqueta

Envie etiqueta com uma etiqueta de 1 a 30 caracteres para listar os links que a têm, sem diferenciar maiúsculas de minúsculas. O filtro também se aplica ao total. Um valor em branco ou com mais de 30 caracteres retorna HTTP 400.

Estrutura da página retornada

Campo	Descrição
`total`	Número de links que correspondem à busca e aos filtros.
`pagina`	Página solicitada, começando em 1.
`por_pagina`	Quantidade máxima de itens por página.
`itens`	Lista de links da página. Cada item contém os campos de Criar link e `cliques_no_mes`.

Quando não há resultados ou a página solicitada ultrapassa a última, itens é uma lista vazia. Para percorrer todas as páginas e lidar com links criados durante a consulta, siga Paginação e filtros.

Parâmetros

Cabeçalho

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

Parâmetros de consulta

paginainteiro: Número da página, a partir de 1. Padrão: 1.
por_paginainteiro: Quantidade de links por página, de 1 a 100. Padrão: 20.
buscatexto: Texto de até 100 caracteres para pesquisar título, destino e código.
usuariointeiro: ID da pessoa cujos links serão listados. Disponível apenas com token da empresa.
etiquetatexto: Etiqueta de 1 a 30 caracteres para filtrar, sem diferenciar maiúsculas de minúsculas.

Exemplo de requisição

curl -sS "https://pqno.app/admin/api/encurtar-link/meuslinks?pagina=1&por_pagina=50" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const links = new Map();
for (let pagina = 1; ; pagina++) {
  const url = new URL('https://pqno.app/admin/api/encurtar-link/meuslinks');
  url.search = new URLSearchParams({ pagina: String(pagina), por_pagina: '100' });
  const resposta = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.PQNO_TOKEN}` }
  });
  const json = await resposta.json();
  if (!resposta.ok || json.status !== 'ok') throw new Error(json.mensagem);
  const { itens, total, por_pagina } = json.dados;
  for (const link of itens) links.set(link.id, link);
  if (itens.length === 0 || pagina * por_pagina >= total) break;
}
console.log([...links.values()]);

<?php
$query = http_build_query(['busca' => 'campanha', 'por_pagina' => 50]);
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/meuslinks?' . $query);
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'] ?? '');
}
foreach ($json['dados']['itens'] as $link) {
    echo $link['url_curta'], ' ', $link['cliques_no_mes'], PHP_EOL;
}

import os
import requests

resposta = requests.get(
    'https://pqno.app/admin/api/encurtar-link/meuslinks',
    headers={'Authorization': f"Bearer {os.environ['PQNO_TOKEN']}"},
    params={'pagina': 1, 'por_pagina': 50},
    timeout=30,
)
corpo = resposta.json()
if corpo['status'] != 'ok':
    raise RuntimeError(corpo['mensagem'])
for link in corpo['dados']['itens']:
    print(link['url_curta'], link['cliques_no_mes'])

Respostas

Página de resultados com total, pagina, por_pagina e itens.

{
  "status": "ok",
  "dados": {
    "total": 57,
    "pagina": 1,
    "por_pagina": 2,
    "itens": [
      {
        "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": null,
        "max_cliques": null,
        "cliques_contados": 0,
        "com_senha": false,
        "etiquetas": ["campanha", "email"],
        "pixels": { "meta": "123456789012345" },
        "cliques_no_mes": 318
      },
      {
        "id": 4790,
        "codigo": "k7p2x9",
        "url_curta": "https://pqno.app/k7p2x9",
        "url": "https://exemplo.com.br/cardapio",
        "titulo": "Cardápio",
        "descricao": "QR Code das mesas",
        "criado_em": "2026-09-28T09:05:44-03:00",
        "criado_por": { "id": 52, "nome": "Rafael Lima" },
        "expira_em": null,
        "max_cliques": null,
        "cliques_contados": 0,
        "com_senha": true,
        "etiquetas": [],
        "pixels": {},
        "cliques_no_mes": 1204
      }
    ]
  }
}

Parâmetro inválido ou desconhecido, ou filtro usuario enviado com token pessoal.

{
  "status": "erro",
  "mensagem": "O parâmetro por_pagina deve ser um número inteiro de 1 a 100."
}

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ã."
}