REST API — Crea integraciones personalizadas
Acceso programático completo a FastLinkIt. Crea enlaces, gestiona contactos, envía mailings, acepta pagos y más — todo desde tu propio código o plugins de CMS.
API de enlaces y códigos QR
Crea, lee, actualiza y elimina enlaces cortos y códigos QR de forma programática. Establece short codes personalizados, parámetros UTM, colores y logo del QR, fechas de expiración y haz seguimiento de las estadísticas de clic por enlace — todo mediante sencillos endpoints JSON.
- Operaciones CRUD completas para enlaces y códigos QR
- Short codes personalizados con validación de disponibilidad
- Parámetros UTM (source, medium, campaign, term, content)
- Personalización del código QR (colores, logo)
- Endpoints de analítica y estadísticas de clics
- Gestión de etiquetas por enlace
API de contactos y grupos
Gestiona tu base de datos de contactos de forma programática. Crea contactos con perfiles completos que incluyen teléfonos, direcciones, sitios web y notas. Organízalos en grupos, añade miembros en masa por email y crea automáticamente contactos faltantes al vuelo.
- CRUD completo de contactos con datos anidados
- Teléfonos, direcciones, sitios web y notas por contacto
- Grupos de contactos con gestión de miembros
- Importación masiva de miembros por email
- Búsqueda y paginación
- Seguimiento de bounces y bajas
API de Mailing por email
Compón y envía campañas de email de forma programática. Selecciona destinatarios de contactos o grupos, usa marcadores de personalización, encola mailings para envío y haz seguimiento del estado de entrega por destinatario en tiempo real.
- Crea borradores de mailing con cuerpo HTML
- Añade destinatarios desde grupos y contactos individuales
- Soporte de marcadores (Name, Email, FirstName, LastName, Company)
- Cola para envío en segundo plano
- Seguimiento de entrega por destinatario
- Filtrado automático de bounces y bajas
API Organizer
Gestiona planners (páginas de reservas), plantillas de evento, slots de disponibilidad y reservas a través de la API. Construye flujos de planificación personalizados, sincroniza con calendarios externos o integra la funcionalidad de booking en tus propias aplicaciones.
- CRUD de planner (páginas de reservas con short codes)
- Gestión de plantillas de evento
- Creación por lotes de slots de disponibilidad
- Gestión de reservas con actualizaciones de estado
- Estados confirmado, cancelado y pendiente
- Soft delete con capacidad de restauración
API Payment
Acepta pagos a través de destination charges de Stripe Connect. Crea productos, genera sesiones de checkout, haz seguimiento de transacciones y procesa reembolsos — todo de forma programática. Las notificaciones webhook con firma HMAC mantienen tus sistemas sincronizados.
- Gestión de productos con precios
- Quick checkout (sin producto pre-creado)
- Stripe destination charges a tu cuenta conectada
- Reembolsos totales y parciales
- Entrega de webhooks con verificación de firma HMAC
- Seguimiento de origen por plataforma
API GeoIP Lookup
Consulta datos de ubicación geográfica para cualquier dirección IP. Obtén detalles completos como continente, país, ciudad, coordenadas, ISP, tipo de conexión y zona horaria. Los resultados se almacenan en caché en la base de datos para consultas repetidas más rápidas.
- Endpoints de consulta completa y simple
- Consulta tu propia IP con /me
- Resolución de continente, país y ciudad
- Coordenadas y zona horaria
- Detección de ISP y tipo de conexión
- Identificación de países UE
API Keys con scope
Genera claves API con permisos granulares. Selecciona exactamente a qué servicios puede acceder cada clave — enlaces, contactos, mailings, pagos y más. Sigue el principio del menor privilegio sin sacrificar funcionalidad.
- 10 scopes configurables (enlaces, QR, contactos, grupos, mailings, etc.)
- Acceso total o restringido por clave
- Fechas de expiración por clave
- Seguimiento de uso (timestamp del último uso)
- Revoca en cualquier momento con efecto inmediato
- Aplicación de acceso según el plan
Autenticación
Tres métodos de autenticación para cada escenario de integración. Usa tokens JWT Bearer para comunicación servidor a servidor, claves API mediante la cabecera X-Api-Key para integraciones sencillas, o autenticación por cookie para la interfaz web.
- Tokens JWT Bearer (login con credenciales)
- Autenticación por API Key vía cabecera X-Api-Key
- Documentación interactiva OpenAPI (Scalar UI)
- Límites de uso por plan aplicados en todos los endpoints
- Soporte CORS para integraciones desde el navegador
Preguntas frecuentes
Todo lo que necesitas saber sobre la REST API de FastLinkIt.
¿Qué métodos de autenticación admite la API?
FastLinkIt admite tres métodos de autenticación: tokens JWT Bearer para integraciones servidor a servidor, claves API mediante la cabecera X-Api-Key para acceso programático sencillo y autenticación por cookie para la interfaz web. Los tokens JWT se obtienen enviando credenciales al endpoint /api/auth/login. Las claves API se generan desde la configuración de tu cuenta.
¿Cómo creo una clave API?
Ve a Cuenta > API Keys en el panel de FastLinkIt. Haz clic en
"Generar nueva clave", dale un nombre y una fecha de expiración opcional, y luego
selecciona qué scopes (permisos) debe tener la clave. La clave en bruto se muestra
solo una vez — cópiala inmediatamente. Las claves usan el prefijo fli_
para facilitar su identificación.
¿Qué son los scopes de las claves API?
Los scopes te permiten limitar lo que cada clave API puede hacer. Hay 10 scopes configurables que cubren enlaces, códigos QR, contactos, grupos, mailings, organizer, pagos, GeoIP, archivos y etiquetas. Puedes conceder acceso total o restringir una clave solo a los servicios que necesita, siguiendo el principio del menor privilegio.
¿Hay un límite de uso?
El uso de la API se rige por tu plan de suscripción. Cada plan define límites mensuales para la creación de enlaces y códigos QR, tamaños de archivos subidos y cuotas de almacenamiento. La API aplica esos mismos límites, por lo que un plan Starter permite 10 enlaces al mes ya sean creados desde el panel o desde la API.
¿Qué planes incluyen acceso a la API?
El acceso a la API está disponible en todos los planes. Los usuarios del plan gratuito pueden crear hasta 5 enlaces al mes vía API. Los planes superiores desbloquean más capacidad de enlaces, subidas de archivos más grandes, almacenamiento adicional y funciones avanzadas como contactos, mailings y organizer.
¿Dónde puedo encontrar la documentación completa de la API?
La documentación interactiva completa de la API está disponible mediante la
interfaz Scalar en /scalar/v1 en tu instancia de
FastLinkIt. La especificación OpenAPI se publica en /openapi/v1.json,
que puedes importar en Postman, Insomnia o cualquier herramienta compatible con OpenAPI.
¿Puedo aceptar pagos a través de la API?
Sí. La API Payment te permite crear productos, generar sesiones de Stripe Checkout con destination charges, hacer seguimiento de transacciones y procesar reembolsos totales o parciales. Los pagos pasan por Stripe Connect, así que los fondos van directamente a tu cuenta de Stripe conectada con una comisión de plataforma configurable. Las notificaciones webhook con firma HMAC mantienen tus sistemas sincronizados.
Empieza a crear con la API hoy
Crea tu cuenta gratuita en segundos. No se requiere tarjeta de crédito.
Genera una clave API, explora la documentación interactiva y lanza tu primera integración.