API acortador de URL: integre URLW en sus aplicaciones

La API REST de URLW le permite integrar la creación, gestión y análisis de enlaces cortos directamente en sus aplicaciones, scripts o flujos de trabajo automatizados. Tanto si construye un CRM, una plataforma de email marketing o una herramienta interna, la API de URLW se integra en unas pocas líneas de código.

Autenticación mediante clave API

Todas las solicitudes a la API de URLW deben autenticarse mediante una clave API transmitida en el encabezado Authorization. Para obtener su clave:

1. Inicie sesión en su cuenta URLW
2. Acceda a Ajustes → API
3. Haga clic en «Generar una nueva clave API»
4. Copie y guarde esta clave en un lugar seguro — solo se mostrará una vez

Transmita su clave en cada solicitud mediante el encabezado HTTP:

Authorization: Bearer SU_CLAVE_API

Nunca exponga su clave API en código del lado del cliente (JavaScript front-end, aplicaciones móviles). Utilice siempre un backend intermedio para las llamadas a la API.

Primeros pasos: acortar una URL con curl

A continuación se muestra cómo crear su primer enlace corto mediante la API de URLW con el comando curl:

curl -X POST https://urlw.fr/api/v1/links \
-H "Authorization: Bearer SU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://ejemplo.com/mi-muy-larga-url-de-destino",
"slug": "mi-enlace",
"domain": "go.su-marca.es"
}'

Respuesta en caso de éxito (HTTP 201):

{
"id": "lnk_abc123",
"short_url": "https://go.su-marca.es/mi-enlace",
"original_url": "https://ejemplo.com/mi-muy-larga-url-de-destino",
"slug": "mi-enlace",
"clicks": 0,
"created_at": "2025-06-01T10:00:00Z"
}

Principales endpoints de la API de URLW

La API de URLW expone los siguientes endpoints REST:

• POST /api/v1/links — Crear un nuevo enlace corto
• GET /api/v1/links — Listar sus enlaces (con paginación)
• GET /api/v1/links/{id} — Obtener un enlace por su identificador
• PATCH /api/v1/links/{id} — Modificar un enlace existente (URL de destino, slug, expiración)
• DELETE /api/v1/links/{id} — Eliminar un enlace
• GET /api/v1/links/{id}/stats — Obtener las estadísticas de clics de un enlace
• POST /api/v1/links/batch — Crear varios enlaces en una sola solicitud

La documentación completa, con parámetros, códigos de respuesta y ejemplos para cada endpoint, está disponible en /es/docs.

Límites de tasa y buenas prácticas

Para garantizar la calidad del servicio para todos los usuarios, la API de URLW aplica límites de tasa (rate limits) según su plan:

• Plan Starter: 60 solicitudes por minuto
• Plan Pro: 300 solicitudes por minuto
• Plan Business: 1 000 solicitudes por minuto

Cuando supere el límite, la API devuelve una respuesta HTTP 429 Too Many Requests con un encabezado Retry-After que indica el tiempo de espera. Implemente un mecanismo de reintento con backoff exponencial en sus aplicaciones.

Buenas prácticas para una integración robusta:

• Utilice el endpoint batch para crear varios enlaces en una sola solicitud en lugar de multiplicar las llamadas individuales
• Almacene en caché las respuestas de la API en su aplicación para evitar consultas en cada visualización
• Gestione sistemáticamente los códigos de error HTTP (400, 401, 404, 422, 429, 500) en su código
• Utilice los webhooks de URLW para recibir notificaciones sobre eventos (clic, expiración) en lugar de hacer polling a la API

Para empezar a utilizar la API, cree su cuenta URLW y consulte la documentación completa de la API.