Documentación de 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 de SDK

Resumen de 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 hacer solicitudes a nuestros endpoints. Todas las solicitudes deben realizarse por HTTPS e incluir tu clave de API en el encabezado.

Autenticación

Autenticación con Clave de API

Incluye tu clave de API en el encabezado 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 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 filtros

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 el perfil de tu negocio, horarios, comodidades y fotos.

GET/business

Obtener el perfil de tu negocio

PUT/business

Actualizar el perfil de tu negocio

POST/business/photos

Subir fotos del negocio

GET/business/reviews

Obtener reseñas de tu negocio

/analytics

Accede a datos analíticos para tu negocio y eventos.

GET/analytics/events

Obtener análisis de tus eventos

GET/analytics/business

Obtener análisis del perfil de tu negocio

GET/analytics/demographics

Obtener datos demográficos de tus visitantes

GET/analytics/reports

Generar informes personalizados

¿Listo para Integrar?

Comienza con nuestra API hoy y conecta tu negocio de estilo de vida con millones de clientes potenciales.

Frequently Asked Questions

¿Qué lenguajes de programación son compatibles?

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 de pruebas sandbox?

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 enterprise ofrecen límites personalizados.

¿Proporcionan notificaciones webhook?

Sí, soportamos webhooks para notificaciones en tiempo real sobre eventos como nuevas confirmaciones, actualizaciones de eventos y cambios en el perfil del negocio.

¿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.