Importación y exportación masiva de enlaces cortos

Cuando tienes decenas o miles de URL que acortar, súbelas en un solo archivo CSV en lugar de crear cada enlace a mano. Cada fila se convierte en un enlace corto normal que puedes editar, compartir y seguir como cualquier otro.

Nota

La creación masiva depende de tu plan. Cada fila creada cuesta lo mismo que crearla a mano, e importar o exportar no tiene coste adicional. Consulta la página de créditos para más detalles. Créditos de funciones

Importar enlaces cortos desde un archivo CSV

1. Abre el Acortador de URL en el panel y elige Importación masiva.

2. Descarga la plantilla CSV, rellena una fila por enlace y guárdala como CSV.

3. Sube el archivo y elige los valores predeterminados para las filas que dejen una columna vacía, como la plantilla o la etiqueta.

4. Comprueba el archivo. Posty5 lee cada fila sin crear nada y lista las filas que fallarían.

5. Inicia la importación. Puedes salir de la página y una notificación te avisará cuando termine.

Las columnas del archivo

Solo la columna url es obligatoria. Los nombres de columna no distinguen mayúsculas y minúsculas, y una columna que Posty5 no conoce se ignora y se indica en el paso de comprobación.

Column
url	La dirección de destino. Obligatoria. También se acepta baseUrl como otro nombre.
name	Un nombre para tu propia lista. Si se deja vacío, Posty5 lo rellena con el título de la página en segundo plano.
customId	Tu propia terminación del enlace corto, cuando tu plan permite ID personalizados. No debe estar en uso, ni siquiera por una fila anterior del mismo archivo.
tag	Una etiqueta para agrupar y filtrar los enlaces más tarde.
refId	Tu propia referencia, por ejemplo un código de producto de tu sistema.
templateId	La plantilla de código QR de esta fila. Sustituye el valor predeterminado que elegiste.

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

Guarda el archivo como CSV UTF-8 con comas y una fila de encabezado. Los valores que contienen comas van entre comillas dobles, como hacen las hojas de cálculo por sí solas.

Comprobación del archivo

La comprobación aplica las mismas reglas que crear un enlace a mano y muestra cada fila con error con su número, contando desde la primera fila bajo el encabezado. Una fila falla cuando

• falta la URL, no es una dirección web válida o tiene más de 2,048 caracteres
• la URL está bloqueada por no ser segura
• un nombre, etiqueta o referencia tiene más de 255 caracteres
• el ID personalizado no está permitido en tu plan, no es válido o ya está en uso
• la plantilla no existe o no es tuya

Límites

• Un archivo admite hasta 5,000 filas y 2 MB.
• Puedes crear hasta 20,000 filas en masa al día (UTC), sumando todas las importaciones y llamadas a la API.
• Se ejecuta una importación a la vez, y hasta tres más pueden esperar.
• Si tus créditos se agotan durante una importación, esa fila y todas las siguientes fallan con «Créditos insuficientes», y los enlaces ya creados se mantienen.

Progreso

La página de importación muestra cuántas filas se procesaron, crearon y fallaron, y se actualiza sola. Puedes cancelar una importación en curso; los enlaces creados antes de cancelar se mantienen.

Los títulos de página y los enlaces profundos de apps se obtienen en segundo plano tras crear cada enlace, así que un enlace puede mostrar su host como nombre durante un rato.

El archivo de resultados

Cuando termine la importación, descarga su archivo de resultados. Tiene una línea por cada fila de tu archivo.

Column
row	El número de fila en tu archivo, contando desde la primera fila bajo el encabezado.
status	created, failed, skipped, o notProcessed cuando la importación se detuvo antes de llegar a la fila.
id, shortUrl	El ID y la dirección corta del nuevo enlace.
errors	Por qué falló la fila.

Un segundo archivo contiene solo las filas con error con tus valores originales, para que las corrijas y vuelvas a subir ese archivo.

Importaciones anteriores

Trabajos masivos lista tus importaciones recientes con su estado y recuentos. Abre una para ver su progreso o volver a descargar sus archivos.

Precaución

Los archivos subidos y los de resultados se guardan 7 días, y el registro de una importación 30 días. Descarga lo que necesites antes. Los enlaces en sí nunca se eliminan.

Creación masiva mediante la API

Los desarrolladores pueden enviar hasta 100 filas en una solicitud y recibir al instante un resultado por fila, o enviar un archivo de hasta 5,000 filas como trabajo y consultarlo. Se aplican los mismos límites y comprobaciones, y la solicitud respeta la cabecera Idempotency-Key para que un reintento no cree enlaces dos veces. Las rutas están documentadas en la referencia de la API (Swagger).

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

Exporta tus enlaces

En la lista de enlaces cortos, elige Exportar CSV o Exportar JSON para descargar tus enlaces con sus contadores de visitas.

• La exportación usa los filtros aplicados a la lista, así que filtra primero para exportar solo una parte.
• Una exportación admite hasta 50,000 filas, las más recientes primero. Una lista más larga se corta ahí, y el archivo lo indica en su última línea (CSV) o en su campo truncated (JSON).
• Una celda que empieza por = + - o @ recibe un apóstrofo inicial en el CSV, para que la hoja de cálculo la muestre como texto en lugar de ejecutarla como fórmula.