Encurtador de links

Excluir link

Exclua um link e seus registros de cliques de forma definitiva.

DELETEhttps://pqno.app/admin/api/encurtar-link/excluirlink

Exclui o link identificado por id na URL da requisição. Use HTTP DELETE. A operação é definitiva.

Efeito da exclusão

O endereço curto deixa de redirecionar para o destino.
Os registros de cliques são removidos das estatísticas e do resumo da conta.
Os QR Codes salvos para esse link são excluídos.
Um QR Code impresso que contém esse endereço curto deixa de abrir o destino, inclusive quando foi criado para rastrear acessos.

Se você precisa apenas trocar o destino e preservar o endereço curto, use Editar link.

Acesso ao link

Um token pessoal pode excluir os links de quem o gerou. Um token da empresa pode excluir os links de qualquer pessoa dessa empresa.

Resposta e repetição

HTTP 200 confirma a exclusão e retorna o ID removido em dados.id. Um link inexistente, já excluído ou fora do acesso do token retorna 404.

Se repetir a requisição após uma exclusão bem-sucedida, a segunda resposta será 404.

Parâmetros

Cabeçalho

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

Parâmetros de consulta

idinteiroobrigatório: ID do link retornado na criação ou na listagem.

Exemplo de requisição

curl -sS -X DELETE "https://pqno.app/admin/api/encurtar-link/excluirlink?id=4821" \
  -H "Authorization: Bearer $PQNO_TOKEN"

const resposta = await fetch('https://pqno.app/admin/api/encurtar-link/excluirlink?id=4821', {
  method: 'DELETE',
  headers: { 'Authorization': `Bearer ${process.env.PQNO_TOKEN}` }
});
const json = await resposta.json();
if (json.status !== 'ok') throw new Error(json.mensagem);
console.log('Excluído:', json.dados.id);

<?php
$ch = curl_init('https://pqno.app/admin/api/encurtar-link/excluirlink?id=4821');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    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 'Excluído: ', $json['dados']['id'];

import os
import requests

resposta = requests.delete(
    'https://pqno.app/admin/api/encurtar-link/excluirlink',
    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('Excluído:', corpo['dados']['id'])

Respostas

Exclusão concluída. O campo dados.id contém o ID removido.

{
  "status": "ok",
  "dados": {
    "id": 4821
  }
}

Link inexistente, já excluído 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ã."
}