Sí. URLHop tiene una API REST pública, con referencia OpenAPI en app.urlhop.me/api/v1/docs/, para crear y editar links cortos, descargar códigos QR, importar links desde CSV, administrar páginas de link en la bio y consultar estadísticas. Está disponible desde el plan Starter y en la prueba gratis de 30 días del plan Pro.

¿Cómo funciona la autenticación de la API?

Con claves de API creadas en Ajustes → API. Cada clave se muestra una sola vez, solo sirve para el espacio de trabajo donde se creó y va en el encabezado Authorization: Bearer. El límite es de 120 solicitudes por minuto por clave, y puedes revocar una clave cuando quieras.

¿Qué eventos envían los webhooks de URLHop?

link.created, link.updated, link.deleted, link.click_limit_reached, tree.created, tree.updated, tree.deleted, domain.verified y usage.threshold_reached, este último cuando la cuenta llega al 80% y al 100% de los clics medidos del mes. Cada entrega es un POST en JSON firmado con HMAC-SHA256.

¿Cómo sé que el webhook viene realmente de URLHop?

Cada entrega trae el encabezado X-URLHop-Signature, con una marca de tiempo y una firma HMAC-SHA256 calculada sobre esa marca y el cuerpo del mensaje, con el secreto que aparece al crear el webhook. Recalcula la firma en tu servidor y rechaza las entregas antiguas o que no coinciden. La documentación incluye un ejemplo listo.

¿URLHop funciona con n8n, Make o Zapier?

Sí, mediante webhooks y la API. Cualquier herramienta que reciba webhooks puede procesar los eventos de URLHop, y cualquier herramienta que haga solicitudes HTTP puede usar la API con una clave. No son integraciones oficiales con esas plataformas, sino funciones abiertas que funcionan con ellas.

¿Qué pasa si mi servidor está caído cuando ocurre un evento?

URLHop reintenta después de 1 minuto, 5 minutos, 30 minutos, 2 horas y 6 horas, y el panel muestra cada entrega y su estado. Tu servidor debe responder con un código 2xx en menos de 5 segundos. Una dirección se desactiva después de 50 fallas seguidas.

API y webhooks: URLHop trabajando dentro de tus sistemas

¿Crear 300 códigos QR a mano para el catálogo nuevo? ¿Cambiar destino por destino cuando tu sitio se muda? Deja que tus sistemas lo hagan. Con una clave de API, crean links y códigos QR, cambian destinos y consultan estadísticas. Con webhooks, URLHop avisa a tus herramientas cuando algo pasa.

Ver la documentación de la API →

Cuando hacerlo a mano ya no alcanza

Una tienda con cientos de productos, una inmobiliaria que publica propiedades todos los días, una agencia que atiende a decenas de clientes. En algún momento, crear y actualizar links desde el panel se vuelve trabajo repetitivo, y el trabajo repetitivo trae errores. La API de URLHop hace lo mismo que el panel, pero desde tu sistema, tu hoja de cálculo o tu herramienta de automatización. Los webhooks hacen el camino inverso: te avisan cuando algo cambia.

Qué puedes hacer con la API

La API de URLHop es REST, responde en JSON y tiene una referencia pública en formato OpenAPI. Con ella creas, editas y borras links cortos; cambias el destino de un código QR ya impreso; descargas el código QR; importas hasta 200 links a la vez desde un CSV; organizas links en carpetas y etiquetas; administras páginas de link en la bio; y consultas las estadísticas de cada link. Las reglas de plan del panel también valen en la API: por ejemplo, ponerle contraseña a un link requiere Pro, y exportar los eventos brutos de estadísticas en JSON requiere Business.

Webhooks: URLHop te avisa cuando algo pasa

Registra una dirección HTTPS y elige los eventos. Con cada evento, URLHop envía un POST con los datos en JSON, firmado con HMAC-SHA256 para que confirmes que viene de nosotros. Si tu sistema está caído, el envío se reintenta durante hasta 9 horas, y el panel muestra el historial de entregas. Los eventos son: link creado, editado o borrado (link.created, link.updated, link.deleted); límite de clics alcanzado (link.click_limit_reached); página de link en la bio creada, editada o borrada (tree.created, tree.updated, tree.deleted); dominio verificado (domain.verified); y 80% o 100% de los clics medidos del mes (usage.threshold_reached). Funciona con cualquier herramienta que reciba webhooks, como n8n, Make o Zapier.

Ejemplos reales de uso

Cómo los equipos conectan URLHop con las herramientas que ya usan.

Quién lo usa y qué pasa

Tienda en línea: cuando se da de alta un producto nuevo, el sistema de la tienda llama a la API, crea el link corto y el código QR y pone el código en la etiqueta. Si la página del producto cambia, el cambio de destino también es automático.
Inmobiliaria: cada propiedad nueva recibe un link y un código QR para el letrero. Cuando la propiedad se vende, el sistema cambia el destino a la lista de propiedades parecidas, y el letrero sigue atrayendo clientes.
Agencia de marketing: cada mes, un script consulta por la API los clics de los links de cada cliente y llena la hoja del reporte, sin que nadie copie números a mano.
Equipo de marketing: el webhook de link editado (link.updated) pasa por un flujo en n8n y manda un mensaje al chat del equipo cada vez que alguien cambia el destino de un código QR impreso. Nadie se lleva sorpresas.
Promoción para los primeros 500, en un plan Pro: el link tiene un límite de 500 clics. Cuando se alcanza, el webhook link.click_limit_reached activa un escenario en Make que avisa en redes que el cupón se agotó.
Finanzas: el webhook usage.threshold_reached avisa cuando la cuenta llega al 80% de los clics medidos del mes, a tiempo para decidir si conviene cambiar de plan antes de que el conteo se pause.

Cómo empezar

En pocos minutos haces tu primera llamada.

Paso a paso

En el panel, ve a Ajustes → API y crea una clave. Ponle un nombre que te recuerde dónde la usarás, como Tienda o CRM.
Copia la clave en ese momento: aparece una sola vez, y URLHop solo guarda su hash.
Envía la clave en el encabezado Authorization: Bearer en cada solicitud. Cada clave accede solo al espacio de trabajo donde se creó, tiene un límite de 120 solicitudes por minuto y se puede revocar en cualquier momento.
Para webhooks, ve a Ajustes → Webhooks, pega la dirección HTTPS, elige los eventos y guarda el secreto de firma, que también aparece una sola vez. Usa el botón Enviar prueba para revisar la integración.
Consulta la documentación pública de la API para ver todas las llamadas, con ejemplos.

En qué plan está

La API y los webhooks están en el plan Starter y en los planes superiores, y también en la prueba gratis de 30 días del plan Pro que recibe toda cuenta nueva, sin tarjeta. Algunas funciones siguen el plan: los enlaces con contraseña y la exportación de estadísticas en CSV son de Pro; la exportación de eventos brutos en JSON por la API es de Business. Si tu cuenta vuelve al plan Free, las claves de API dejan de funcionar hasta que vuelvas a suscribirte, pero ningún link se desactiva.

Probar la API gratis por 30 días