Crear Link

POST /api/v1/links

Crea un nuevo short link acortado.

Permiso requerido: shortlinks:write

Request Body

{
  "target_url": "https://ejemplo.com/pagina-muy-larga",
  "title": "Mi campaña Q1",
  "domain_id": "64a1b2c3d4e5f6...",
  "redirect_type": 302,
  "tags": ["marketing", "q1"]
}

Campo	Tipo	Requerido	Descripción
target_url	string	✅	URL destino a acortar
title	string	❌	Título descriptivo del link
domain_id	string	❌	ID del dominio personalizado
redirect_type	integer	❌	Tipo de redirección: 301, 302 (default), 307
tags	string[]	❌	Etiquetas para organizar

Response 201 Created

{
  "id": "64a1b2c3d4e5f6...",
  "code": "a1B2",
  "short_url": "https://go.linkea.us/a1B2",
  "target_url": "https://ejemplo.com/pagina-muy-larga",
  "title": "Mi campaña Q1",
  "redirect_type": 302,
  "is_active": true,
  "click_count": 0,
  "tags": ["marketing", "q1"],
  "created_at": "2025-01-15T10:30:00Z"
}

Ejemplo con cURL

curl -X POST https://api.linkea.us/api/v1/links \
  -H "X-Api-Key: lk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://ejemplo.com/pagina-larga",
    "title": "Mi link"
  }'

Errores

Status	Descripción
400	target_url faltante o inválida
401	API key inválida o faltante
403	Permiso shortlinks:write requerido
429	Rate limit excedido