Importação e exportação em massa de links curtos

Quando você tem dezenas ou milhares de URLs para encurtar, envie-os em um único arquivo CSV em vez de criar cada link manualmente. Cada linha vira um link curto normal que você pode editar, compartilhar e acompanhar como qualquer outro.

Importar links curtos de um arquivo CSV

Abra o Encurtador de URL no painel e escolha Importação em massa.
Baixe o modelo CSV, preencha uma linha por link e salve como CSV.
Envie o arquivo e escolha os padrões aplicados às linhas que deixam uma coluna vazia, como o modelo ou a tag.
Verifique o arquivo. O Posty5 lê cada linha sem criar nada e lista as linhas que falhariam.
Inicie a importação. Você pode sair da página, e uma notificação avisa quando terminar.

As colunas do arquivo

Apenas a coluna url é obrigatória. Os nomes das colunas não diferenciam maiúsculas de minúsculas, e uma coluna que o Posty5 não conhece é ignorada e informada na etapa de verificação.

Column
`url`	O endereço de destino. Obrigatório. baseUrl também é aceito como outro nome.
`name`	Um nome para a sua própria lista. Se ficar vazio, o Posty5 preenche com o título da página em segundo plano.
`customId`	Seu próprio final para o link curto, quando seu plano permite IDs personalizados. Ele não pode estar em uso, nem por uma linha anterior do mesmo arquivo.
`tag`	Uma tag para agrupar e filtrar os links depois.
`refId`	Sua própria referência, por exemplo um código de produto do seu sistema.
`templateId`	O modelo de código QR desta linha. Ele substitui o padrão que você escolheu.

url,name,customId,tag,refId,templateId
https://example.com/spring-sale,Spring sale,,spring,,

Salve o arquivo como CSV UTF-8 com vírgulas e uma linha de cabeçalho. Valores que contêm vírgulas ficam entre aspas duplas, como as planilhas fazem automaticamente.

Verificação do arquivo

A verificação aplica as mesmas regras da criação manual de um link e mostra cada linha com falha com seu número, contando a partir da primeira linha abaixo do cabeçalho. Uma linha falha quando

o URL está ausente, não é um endereço web válido ou tem mais de 2,048 caracteres
o URL está bloqueado por ser inseguro
um nome, tag ou referência tem mais de 255 caracteres
o ID personalizado não é permitido no seu plano, é inválido ou já está em uso
o modelo não existe ou não é seu

Limites

Um arquivo comporta até 5,000 linhas e 2 MB.
Você pode criar até 20,000 linhas em massa por dia (UTC), somando todas as importações e chamadas de API.
Uma importação roda por vez, e até mais três podem aguardar.
Se seus créditos acabarem durante uma importação, essa linha e todas as seguintes falham com “Créditos insuficientes”, e os links já criados permanecem.

Progresso

A página de importação mostra quantas linhas foram processadas, criadas e falharam, e se atualiza sozinha. Você pode cancelar uma importação em andamento; os links criados antes do cancelamento permanecem.

Os títulos das páginas e os deep links de apps são buscados em segundo plano após a criação de cada link, então um link pode mostrar o host como nome por um tempo.

O arquivo de resultados

Quando a importação terminar, baixe o arquivo de resultados. Ele tem uma linha por linha do seu arquivo.

Column
`row`	O número da linha no seu arquivo, contando a partir da primeira linha abaixo do cabeçalho.
`status`	created, failed, skipped, ou notProcessed quando a importação parou antes de chegar à linha.
`id`, `shortUrl`	O ID e o endereço curto do novo link.
`errors`	Por que a linha falhou.

Um segundo arquivo contém apenas as linhas com falha e seus valores originais, para você corrigi-las e enviar esse arquivo de novo.

Importações anteriores

Tarefas em massa lista suas importações recentes com status e contagens. Abra uma para ver o progresso ou baixar os arquivos de novo.

Criação em massa pela API

Desenvolvedores podem enviar até 100 linhas em uma requisição e receber na hora um resultado por linha, ou enviar um arquivo de até 5,000 linhas como job e consultá-lo. Os mesmos limites e verificações se aplicam, e a requisição respeita o cabeçalho Idempotency-Key para que uma nova tentativa não crie links duas vezes. As rotas estão documentadas na referência da API (Swagger).

POST /api/short-link/bulk
POST /api/link-bulk-jobs
GET /api/short-link/export

Exporte seus links

Na lista de links curtos, escolha Exportar CSV ou Exportar JSON para baixar seus links com os contadores de visitas.

A exportação usa os filtros aplicados à lista, então filtre antes para exportar só uma parte.
Uma exportação comporta até 50,000 linhas, as mais recentes primeiro. Uma lista maior é cortada nesse ponto, e o arquivo informa isso na última linha (CSV) ou no campo truncated (JSON).
Uma célula que começa com = + - ou @ recebe um apóstrofo inicial no CSV, para que a planilha a mostre como texto em vez de executá-la como fórmula.