Documentación de la API

Integra tu negocio de estilo de vida y eventos con la plataforma Swingular

Autenticación

Acceso seguro a la API con OAuth 2.0 y claves de API

Endpoints

API REST completa para eventos, perfiles y más

Documentación

Guías detalladas, ejemplos y referencias del SDK

Visión General de la API

Primeros Pasos

1. Regístrate como Socio

Antes de acceder a la API, necesitas registrarte como socio de Swingular. Es gratuito y te da acceso a nuestro nivel básico de API.

2. Genera Claves de API

Una vez registrado, puedes generar claves de API desde tu panel de socio. Estas claves se usan para autenticar tus solicitudes a la API.

3. Realiza Solicitudes a la API

Usa tus claves de API para realizar solicitudes a nuestros endpoints. Todas las solicitudes deben hacerse a través de HTTPS e incluir tu clave de API en la cabecera.

Autenticación

Autenticación con Clave de API

Incluye tu clave de API en la cabecera Authorization de tus solicitudes:

Authorization: Bearer YOUR_API_KEY

OAuth 2.0

Para aplicaciones que necesitan acceder a datos de usuarios, usa OAuth 2.0:

// Step 1: Redirect to authorization URL
https://api.swingular.com/oauth/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=YOUR_REDIRECT_URI&
  response_type=code&
  scope=events.read,events.write

Límites de Velocidad

Plan Básico

• 1,000 requests per day
• 60 requests per minute
• Cached responses for high-volume endpoints

Plan Premium

• 10,000 requests per day
• 300 requests per minute
• Priority access during high traffic
• Dedicated support for API integration

Endpoints de la API

/events

Crea, lee, actualiza y elimina eventos. Filtra por fecha, ubicación y tipo.

GET/events

Listar todos los eventos con paginación y filtrado

POST/events

Crear un nuevo evento

GET/events/{id}

Obtener un evento específico por ID

PUT/events/{id}

Actualizar un evento existente

/business

Gestiona tu perfil de negocio, horarios, servicios y fotos.

GET/business

Obtener tu perfil de negocio

PUT/business

Actualizar tu perfil de negocio

POST/business/photos

Subir fotos del negocio

GET/business/reviews

Obtener reseñas de tu negocio

/analytics

Accede a datos de análisis de tu negocio y eventos.

GET/analytics/events

Obtener análisis de tus eventos

GET/analytics/business

Obtener análisis de tu perfil de negocio

GET/analytics/demographics

Obtener datos demográficos de tus visitantes

GET/analytics/reports

Generar informes personalizados

¿Listo para Integrar?

Empieza a usar nuestra API hoy y conecta tu negocio de estilo de vida con millones de clientes potenciales.

Frequently Asked Questions

¿Qué lenguajes de programación están soportados?

Nuestra API REST funciona con cualquier lenguaje de programación que pueda hacer solicitudes HTTP. Proporcionamos SDKs para JavaScript, Python, PHP y .NET, con más lenguajes próximamente.

¿Hay un entorno sandbox para pruebas?

Sí, proporcionamos un entorno sandbox completo con datos de prueba que refleja nuestra API de producción. Todos los socios tienen acceso al sandbox durante el proceso de integración.

¿Cuáles son los límites de velocidad de la API?

Los socios básicos obtienen 1.000 solicitudes por día y 60 por minuto. Los socios premium obtienen 10.000 solicitudes por día y 300 por minuto. Los planes empresariales ofrecen límites personalizados.

¿Proporcionáis notificaciones webhook?

Sí, admitimos webhooks para notificaciones en tiempo real sobre eventos como nuevas confirmaciones, actualizaciones de eventos y cambios en el perfil del negocio. Los endpoints de webhook son configurables en tu panel de socio.

¿Cómo obtengo soporte durante la integración?

Todos los socios tienen acceso a nuestro equipo de soporte para desarrolladores. Los socios premium reciben soporte prioritario con especialistas de integración dedicados y tiempos de respuesta más rápidos.