API v1

Primeros pasos

Bienvenido a la documentación de la API de lnk24co. Esta guía te ayudará a comenzar rápidamente.

Esta documentación está disponible solo en inglés.

URL base

Todas las solicitudes de API deben enviarse a la siguiente URL base:

https://lnk24.co/api/v1

Autenticación

Autentica tus solicitudes de API incluyendo tu clave de API en el encabezado Authorization como un token Bearer. Authorization

curl https://lnk24.co/api/v1/links \
  -H "Authorization: Bearer lnk_live_abc123def456" \
  -H "Content-Type: application/json"

Puedes generar claves de API en la configuración de tu panel. Mantén tus claves seguras y nunca las expongas en código del lado del cliente. configuración del panel

Crea tu primer enlace

Aquí tienes un ejemplo completo de cómo crear un enlace corto vía la API:

curl -X POST https://lnk24.co/api/v1/links \
  -H "Authorization: Bearer lnk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/my-very-long-url-here",
    "custom_code": "my-link",
    "title": "My First Short Link",
    "tags": "marketing,launch"
  }'

Formato de respuesta

Todas las respuestas de la API se devuelven en formato JSON. Las respuestas exitosas incluyen un campo "data". Los errores incluyen un campo "error" con un mensaje y un código.

// Success response
{
  "data": {
    "id": "lnk_abc123",
    "short_url": "https://lnk24.co/my-link",
    "url": "https://example.com/my-very-long-url-here",
    "clicks": 0,
    "created_at": "2026-03-15T10:30:00Z"
  }
}

// Error response
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The url field is required."
  }
}

Paginación

Los endpoints de listado soportan paginación basada en cursor usando los parámetros de consulta "cursor" y "limit". El tamaño de página predeterminado es 25 y el máximo es 100.

GET /v1/links?limit=10&cursor=eyJpZCI6Imxua18xMjM0NSJ9

{
  "data": [...],
  "pagination": {
    "next_cursor": "eyJpZCI6Imxua18xMjM1NSJ9",
    "has_more": true
  }
}

Enlaces rápidos

Ir a endpoints comunes de la API: