API, Zapier y asistentes de IA
Crea y administra KuikLinks desde tus propios sistemas con la API, desde Zapier o pidiéndoselo a un asistente de IA.
Todo lo que haces con los KuikLinks en el panel también se puede hacer desde fuera. La API y Zapier están incluidos desde PRO; los asistentes de IA (MCP) están incluidos en Business.
API
Los links tienen su propio recurso, /links, junto a /codes. Envía tu clave de API como bearer token, igual que en cada llamada; consulta Autenticación.
curl https://api.kuikcode.com/v1/links \
-H "Authorization: Bearer kc_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 5f1c2a9e-oferta-primavera" \
-d '{
"url": "https://example.com/oferta-primavera",
"name": "Oferta de primavera",
"slug": "oferta-primavera",
"tags": ["campaña"],
"utm": { "source": "newsletter", "medium": "email" }
}'La respuesta trae la dirección para compartir en shortUrl:
{
"id": "L7c2Qp9XrT4vBn81ZsKdE",
"name": "Oferta de primavera",
"url": "https://example.com/oferta-primavera",
"shortUrl": "https://kuik.sh/oferta-primavera",
"state": "ok",
"clicks": 0
}| Llamada | Qué hace |
|---|---|
GET /links | Lista los links. Filtra con q, folderId, tag, tenantId o externalId |
POST /links | Crea un link |
GET /links/{id} | Lee un link |
PATCH /links/{id} | Cambia un link. Envía solo los campos que cambian |
DELETE /links/{id} | Elimina un link |
POST /links/bulk | Crea muchos links, todos o ninguno. dryRun: true solo revisa |
POST /links/{id}/code | Crea un KuikCode que abre el link |
GET /scans?kind=link | Lee los clics. Agrega linkId para un solo link |
POST /track/lead, POST /track/sale | Reporta un lead o una venta para un clic. Consulta Seguimiento de conversiones |
Lo que conviene saber:
- Una dirección rechazada responde
422con el códigourl_refused. Elmessagedice por qué: la dirección está mal formada, es otro link corto o aparece en una lista de sitios no seguros. Los demás errores funcionan como en el resto de la API; consulta Errores. statete dice si un link está activo.okestá activo.reviewyflaggedestán activos detrás de una página de aviso.blockedno redirige. Consulta Seguridad.externalIdes tu propio id para un link, único en el espacio de trabajo. Úsalo para encontrar un link que creaste desde tu sistema:GET /links?externalId=pedido-10432.- Los límites del plan aplican igual que en el panel: los links por mes, los finales legibles desde Core, el vencimiento desde PRO. Un rechazo responde
403y nombra el límite. - Los clics y los escaneos nunca se mezclan.
GET /scansy las llamadas de analíticas leen escaneos de KuikCodes, salvo que envíeskind=link. En un clic,viaesqrcuando la visita llegó por el KuikCode del link. - Envía un encabezado
Idempotency-Keyen cadaPOSTpara que un reintento nunca cree un segundo link; consulta Idempotencia.
Zapier
La app de KuikCode para Zapier tiene tres pasos para links:
| Paso | Qué hace |
|---|---|
| New Short Link Click (disparador) | Inicia un Zap cuando alguien abre uno de tus links, o el link que elijas |
| Create Short Link (acción) | Crea un link y devuelve la dirección corta |
| Find Short Link (búsqueda) | Encuentra un link por su destino, nombre o final, y puede crearlo cuando ninguno coincide |
Conecta tu espacio de trabajo como se explica en App de KuikCode para Zapier.
Asistentes de IA
Con el servidor MCP conectado, un asistente puede trabajar con tus links en palabras simples: "acorta este link y llámalo Oferta de primavera", "apunta el link del newsletter a la página nueva", "cuántos clics tuvo el link de la bio esta semana", "haz un código QR para ese link".
Puede listar, leer, crear y actualizar links, crear un KuikCode para un link y leer los clics. No puede eliminar un link.
Seguridad y reportes
Cómo se revisan los links, qué significan los estados y cómo reportar uno.
Reglas inteligentes, geolocalización y geocercas
Un código impreso, muchos destinos. Dirige un escaneo según la hora, la fecha, el día, el país, el idioma, el sistema operativo, la distancia a un lugar o las veces que se ha escaneado el código.