Encurtador de links

Resumo da conta

Consulte links, cliques, destinos indisponíveis e consumo da API em uma requisição.

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

Reúne os números dos links acessíveis ao token e o consumo da API. Com token da empresa, inclui também as métricas de cada pessoa.

Período dos cliques

inicio e fim seguem as regras de Estatísticas de um link: datas em AAAA-MM-DD, período de até 366 dias e, quando omitidas, os últimos 30 dias.

O período se aplica a cliques.no_periodo e a pessoas[].cliques_no_periodo. O campo cliques.hoje sempre se refere ao dia atual, e os totais de links mostram a situação atual da conta.

Campos do resumo

Campo	Descrição
`escopo`	`pessoal` para o token pessoal ou `empresa` para o token da empresa.
`plano`	Plano aplicado ao token: `pro` ou `business`.
`periodo`	Datas de início e fim usadas na consulta de cliques.
`links.total`	Quantidade atual de links no escopo do token.
`links.limite`	Limite de links do plano, ou `null` quando não há limite.
`links.fora_do_ar`	Quantidade de links com destino registrado como indisponível.
`cliques.no_periodo / cliques.hoje`	Cliques no período solicitado e no dia atual.
`api`	Consumo diário e limite por minuto: `cota_diaria`, `usadas_hoje`, `restantes_hoje` e `limite_por_minuto`.

Esta consulta consome uma requisição da cota diária. O valor de api.usadas_hoje já inclui a chamada do resumo.

Métricas por pessoa no Business

O campo pessoas é incluído no token da empresa e ordenado pelos cliques no período, do maior para o menor. Cada item contém:

Campo	Descrição
`id / nome`	Identificação da pessoa. Use `id` no filtro `usuario` de Listar links.
`ativo`	Indica se a pessoa ainda tem acesso à empresa.
`links`	Quantidade de links criados pela pessoa na empresa.
`cliques_no_periodo`	Cliques nesses links durante o período solicitado.

Pessoas que perderam o acesso podem continuar na lista quando ainda têm links na empresa. Seus registros aparecem com ativo: false.

Parâmetros

Cabeçalho

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

Parâmetros de consulta

iniciotexto: Primeira data do período, em AAAA-MM-DD. Se omitida, o período começa 29 dias antes de fim.
fimtexto: Última data do período, em AAAA-MM-DD. Padrão: hoje. A data é incluída na consulta.

Exemplo de requisição

curl -sS "https://pqno.app/admin/api/encurtar-link/resumo?inicio=2026-09-01&fim=2026-09-30" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const resposta = await fetch('https://pqno.app/admin/api/encurtar-link/resumo', {
  headers: { 'Authorization': `Bearer ${process.env.PQNO_TOKEN}` }
});
const json = await resposta.json();
if (json.status !== 'ok') throw new Error(json.mensagem);
console.log('Chamadas que ainda cabem hoje:', json.dados.api.restantes_hoje);
for (const pessoa of json.dados.pessoas ?? []) {
  console.log(pessoa.nome, pessoa.links, pessoa.cliques_no_periodo);
}

<?php
$query = http_build_query(['inicio' => '2026-09-01', 'fim' => '2026-09-30']);
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/resumo?' . $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'] ?? '');
}
echo $json['dados']['links']['total'], ' links, ', $json['dados']['cliques']['no_periodo'], ' cliques', PHP_EOL;
foreach ($json['dados']['pessoas'] ?? [] as $pessoa) {
    echo $pessoa['nome'], ': ', $pessoa['cliques_no_periodo'], PHP_EOL;
}

import os
import requests

resposta = requests.get(
    'https://pqno.app/admin/api/encurtar-link/resumo',
    headers={'Authorization': f"Bearer {os.environ['PQNO_TOKEN']}"},
    timeout=30,
)
corpo = resposta.json()
if corpo['status'] != 'ok':
    raise RuntimeError(corpo['mensagem'])
print('Restam hoje:', corpo['dados']['api']['restantes_hoje'])
for pessoa in corpo['dados'].get('pessoas', []):
    print(pessoa['nome'], pessoa['links'], pessoa['cliques_no_periodo'])

Respostas

Métricas da conta e consumo da API. O token da empresa também inclui a lista pessoas.

{
  "status": "ok",
  "dados": {
    "escopo": "empresa",
    "plano": "business",
    "periodo": {
      "inicio": "2026-09-04",
      "fim": "2026-10-03"
    },
    "links": {
      "total": 214,
      "limite": null,
      "fora_do_ar": 2
    },
    "cliques": {
      "no_periodo": 18230,
      "hoje": 412
    },
    "api": {
      "cota_diaria": 10000,
      "usadas_hoje": 1286,
      "restantes_hoje": 8714,
      "limite_por_minuto": 60
    },
    "pessoas": [
      {
        "id": 37,
        "nome": "Marina Souza",
        "ativo": true,
        "links": 96,
        "cliques_no_periodo": 11540
      },
      {
        "id": 52,
        "nome": "Rafael Lima",
        "ativo": true,
        "links": 81,
        "cliques_no_periodo": 5902
      },
      {
        "id": 18,
        "nome": "Paula Mendes",
        "ativo": false,
        "links": 37,
        "cliques_no_periodo": 788
      }
    ]
  }
}

Parâmetro desconhecido, data inválida ou período fora dos limites.

{
  "status": "erro",
  "mensagem": "O período vai até 366 dias."
}

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