API Pública

Integra las herramientas de Clico en tu aplicación. Acorta URLs, genera códigos QR y crea UTMs programáticamente.

Autenticación

Todas las peticiones requieren un header Authorization con tu API key:

curl -X POST https://clico.app/api/public/shorten \
  -H "Authorization: Bearer mk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://ejemplo.com"}'

Obtén tu API key en Dashboard → API Keys

Endpoints

POST/api/public/shorten

Acorta una URL.

Body (JSON):

{
  "url": "https://ejemplo.com/pagina-larga"
}

Respuesta:

{
  "shortUrl": "https://clico.app/s/abc123",
  "slug": "abc123",
  "id": "clx..."
}

POST/api/public/utm

Genera una URL con parámetros UTM.

Body (JSON):

{
  "url": "https://ejemplo.com",
  "source": "instagram",
  "medium": "social",
  "campaign": "lanzamiento-2026",
  "term": "marketing",    // opcional
  "content": "boton-cta"  // opcional
}

Respuesta:

{
  "url": "https://ejemplo.com?utm_source=instagram&utm_medium=social&utm_campaign=lanzamiento-2026&utm_term=marketing&utm_content=boton-cta",
  "params": { ... }
}

POST/api/public/qr

Genera un código QR como data URL (base64).

Body (JSON):

{
  "url": "https://ejemplo.com",
  "size": 300,       // opcional, default 300
  "color": "#000000" // opcional
}

Respuesta:

{
  "qr": "data:image/png;base64,..."
}

Límites

Plan	Requests/mes	Precio
Free	100	$0
Pro	10,000	$5/mes
Enterprise	100,000	Contactar

Códigos de error

Código	Significado
401	API key inválida o faltante
400	Parámetros faltantes o inválidos
429	Límite de requests mensual alcanzado
500	Error interno del servidor