Encurtador de links

Editar link

Atualize o destino, o código, o título ou a descrição de um link existente.

PATCHhttps://pqno.app/admin/api/encurtar-link/editarlink

Atualiza um link identificado por id na URL da requisição. Use HTTP PATCH e envie um objeto JSON com pelo menos um dos campos url, codigo, titulo, descricao, expira_em, max_cliques, senha, etiquetas ou pixels.

Envie apenas os campos a alterar

Campos omitidos mantêm seus valores. Para limpar o título ou a descrição, envie uma string vazia. Os tipos, tamanhos e regras de destino e código são os mesmos de Criar link.

Alteração do destino

Alterar url mantém o endereço curto e passa a redirecioná-lo para o novo destino. Isso permite atualizar o destino de um QR Code que contém esse endereço curto. O novo destino é agendado para verificação de disponibilidade.

Alteração do código

Alterar codigo muda a URL curta. O endereço anterior continua abrindo o mesmo link, inclusive em QR Codes e materiais impressos, e fica reservado para quem o usava. Cada link guarda até 20 endereços anteriores, e ao passar disso o mais antigo deixa de abrir. Um código já utilizado ou reservado retorna HTTP 409; enviar o código atual mantém o endereço.

Alteração das regras de acesso

expira_em, max_cliques e senha seguem os formatos de Criar link. Omitir um campo mantém o valor atual, e null remove a regra. Uma senha nova substitui a anterior.

Alterar max_cliques zera a contagem, e repetir o valor mantém a contagem. Enviar expira_em no passado retorna HTTP 400, exceto ao repetir a data que o link já tem.

Alteração das etiquetas

Enviar etiquetas substitui a lista inteira do link. Lista vazia ou null remove todas. Omitir o campo mantém as atuais.

Alteração dos pixels

Enviar pixels altera apenas os serviços informados. Um ID substitui o atual, null remove o serviço e os serviços omitidos permanecem como estão. "pixels": null remove todos. A remoção é sempre permitida, mesmo após perder o plano exigido ou a permissão da instalação.

Acesso e resposta

Um token pessoal pode editar os links de quem o gerou. Um token da empresa pode editar os links de qualquer pessoa dessa empresa. A autoria em criado_por é preservada.

HTTP 200 retorna o link atualizado em dados, com os campos descritos em Criar link. Um link inexistente ou fora do acesso do token retorna 404.

Parâmetros

Cabeçalho

Authorizationtextoobrigatório: Envie Bearer seguido do token da API, como Authorization: Bearer SEU_TOKEN.
Content-Typetextoobrigatório: Use application/json para enviar o corpo como JSON.

Parâmetros de consulta

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

Corpo (JSON)

urltexto: URL de destino HTTP ou HTTPS, com até 2.048 caracteres.
codigotexto: Código personalizado de 3 a 50 caracteres. Use letras minúsculas, números, hífen ou sublinhado; comece e termine com letra ou número.
titulotexto: Título do link, com até 255 caracteres.
descricaotexto: Descrição do link, com até 500 caracteres.
expira_emtexto: Nova data e hora de expiração, no formato de Criar link. null remove a expiração.
max_cliquesinteiro: Novo limite de cliques. null remove o limite. Alterar o valor zera a contagem de cliques.
senhatexto: Nova senha, de 4 a 64 caracteres. null remove a senha.
etiquetaslista: Substitui as etiquetas do link. Lista vazia ou null remove todas.
pixelsobjeto: Altera só os serviços informados: um ID troca o atual e null remove o serviço. null no campo remove todos. Remover é sempre permitido.