Shlink - Acortador de URLs Profesional

Shlink es un acortador de URLs self-hosted que te permite crear enlaces cortos personalizados y rastrear estadisticas de clics.

¿Para que sirve?

• Acortar URLs largas - Convierte enlaces largos en URLs cortas y memorables
• Rastrear clics - Ve cuantas personas hacen clic, de donde vienen, que dispositivo usan
• URLs personalizadas - Crea enlaces como tudominio.com/promo en lugar de codigos aleatorios
• QR Codes - Genera codigos QR automaticamente para cada enlace
• Multiples dominios - Usa varios dominios cortos desde una sola instancia

Alternativa Open Source a

• Bitly
• TinyURL
• Rebrandly
• Short.io
• T2M

¿Por que elegir Shlink sobre alternativas SaaS?

Caracteristica	Shlink	Alternativas SaaS
Costo	Precio fijo mensual	Por clic/enlace
Datos	En tu servidor	En servidores externos
Limites	Sin limites de clics	Limites por plan
Branding	Tu dominio	Dominio compartido
Privacidad	100% tuya	Datos compartidos

Ejemplos de uso

• Marketing - Rastrea clics en campanas de email, redes sociales, anuncios
• Eventos - Crea URLs cortas para formularios de registro
• Impresiones - URLs cortas para tarjetas de presentacion, flyers, carteles
• Afiliados - Rastrea clics en enlaces de afiliado
• Documentos - URLs cortas para PDFs, presentaciones, videos

Requisitos minimos

Recurso	Minimo	Recomendado
CPU	1 vCPU	2 vCPU
RAM	512 MB	1 GB
Almacenamiento	10 GB	25 GB

Configuracion inicial

Al desplegar Shlink, se genera automaticamente:

• API Key - Para acceder a la API y crear enlaces programaticamente
• Base URL - Tu dominio tuapp.deployalo.com

GeoLite2 (Opcional)

Para ver de que pais vienen tus visitas, puedes agregar una licencia GeoLite2 gratuita:

1. Registrate gratis en MaxMind
2. Ve a Account > Manage License Keys
3. Crea una nueva licencia
4. Agregala en Configuracion Avanzada al desplegar

Guia completa de GeoLite2

Primeros pasos

1. Obtener tu API Key

Tu API Key se genera automaticamente durante el deployment. La puedes ver en:

1. Panel de Deployalo > Tu deployment > Tab Tecnico
2. Variables de entorno > INITIAL_API_KEY

2. Crear tu primer enlace corto

Puedes usar la API directamente:

curl -X POST https://tuapp.deployalo.com/rest/v3/short-urls \
  -H "X-Api-Key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "longUrl": "https://mi-sitio-largo.com/pagina-con-url-muy-larga",
    "customSlug": "promo"
  }'

O instala un cliente web (ver siguiente seccion).

3. Instalar cliente web (Shlink Web)

Shlink es solo la API. Para una interfaz grafica, puedes usar:

Opcion A: Shlink Web Client (oficial)

• Descarga desde shlink.io/apps
• Es una app estatica que se conecta a tu API

Opcion B: Usar desde linea de comandos

• Instala el CLI: npm install -g @shlinkio/shlink-web-client

Crear enlaces cortos

Via API

# Crear enlace con slug personalizado
curl -X POST https://tuapp.deployalo.com/rest/v3/short-urls \
  -H "X-Api-Key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "longUrl": "https://ejemplo.com/pagina",
    "customSlug": "mi-enlace",
    "tags": ["marketing", "2024"]
  }'

Opciones disponibles

Parametro	Descripcion
longUrl	URL original a acortar (requerido)
customSlug	Slug personalizado (ej: promo)
tags	Etiquetas para organizar
validSince	Fecha desde cuando es valido
validUntil	Fecha de expiracion
maxVisits	Limite de clics

Ver estadisticas

# Estadisticas de un enlace
curl https://tuapp.deployalo.com/rest/v3/short-urls/CODIGO/visits \
  -H "X-Api-Key: TU_API_KEY"

Respuesta incluye:

• Total de visitas
• Visitas por fecha
• Paises (si tienes GeoLite)
• Navegadores y dispositivos
• Referrers (de donde vienen)

Generar QR Code

Cada enlace corto tiene un QR automatico:

https://tuapp.deployalo.com/CODIGO/qr-code

Opciones:

• ?size=300 - Tamano en pixels
• ?format=png - Formato (png, svg)
• ?margin=10 - Margen alrededor

Recursos adicionales

• Documentacion oficial
• API Reference
• GitHub

Solucion de problemas

No puedo crear enlaces

1. Verifica tu API Key en las variables de entorno
2. Asegurate de incluir el header X-Api-Key

Las estadisticas de pais no aparecen

Necesitas configurar GeoLite2:

1. Registrate en MaxMind (gratis)
2. Agrega tu License Key en la configuracion

Los enlaces no redirigen

1. Verifica que el enlace exista: GET /rest/v3/short-urls/CODIGO
2. Revisa que no haya expirado (validUntil)
3. Revisa que no haya alcanzado el limite de visitas (maxVisits)