API REST de Gestonix

Integra la gestion de eventos de tu empresa con cualquier sistema externo. Accede a eventos, clientes, artistas, presupuestos y facturas de forma programatica.

Autenticacion

Todas las peticiones a la API requieren un token Bearer. Para obtener tu token, solicita acceso a traves del formulario de esta pagina. Una vez aprobado, recibiras un token que debes incluir en cada peticion.

HTTP Header
Authorization: Bearer sk_live_tu_token_aqui
Content-Type: application/json
Accept: application/json
cURL - Ejemplo
curl -X GET https://api.gestonix.com/v1/eventos \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json"
Importante sobre seguridad
Nunca expongas tu token API en codigo del lado del cliente. Utiliza siempre las llamadas desde tu servidor backend. Si tu token ha sido comprometido, regeneralo inmediatamente.

Limites de uso

Los limites dependen de tu plan de suscripcion. Si necesitas un limite superior, contacta con nuestro equipo.

PlanPeticiones / horaPeticiones / diaWebhooksSoporte
Starter5005.0003 endpointsEmail
Professional2.00020.00010 endpointsEmail + Chat
Enterprise10.000100.000IlimitadosPrioritario 24/7

Codigos de error

La API utiliza codigos de estado HTTP estandar.

200Peticion exitosa
201Recurso creado
400Peticion mal formada
401No autenticado
403Sin permisos
404No encontrado
422Error de validacion
429Limite excedido
500Error interno
503Servicio no disponible

Eventos

Gestiona eventos: conciertos, bodas, fiestas corporativas y cualquier tipo de evento.

GET/v1/eventos

Listado paginado de eventos. Soporta filtros por fecha, tipo, estado y artista.

pageintegerPagina (defecto: 1)
per_pageintegerResultados por pagina (max: 100)
tipostringboda, concierto, corporativo, festival
estadostringtentativo, confirmado, produccion, completado
fecha_desdedateFormato YYYY-MM-DD
fecha_hastadateFormato YYYY-MM-DD
Respuesta 200 OK
{
  "data": [
    {
      "id": 1,
      "nombre": "Boda Martinez-Garcia",
      "tipo": "boda",
      "fecha": "2026-04-15",
      "hora_inicio": "18:00",
      "hora_fin": "02:00",
      "ubicacion": "Finca El Olivar, Madrid",
      "estado": "confirmado",
      "importe": 8500.00,
      "cliente": { "id": 12, "nombre": "Ana Martinez" },
      "artistas": [{ "id": 3, "nombre": "DJ Carlos" }]
    }
  ],
  "meta": { "total": 47, "page": 1, "per_page": 25 }
}
POST/v1/eventos

Crea un nuevo evento.

nombrestringrequeridoNombre del evento
tipostringrequeridoboda, concierto, corporativo, festival, otro
fechadaterequeridoYYYY-MM-DD
hora_iniciotimeHH:MM
ubicacionstringDireccion del lugar
cliente_idintegerID del cliente
importedecimalImporte total
GET/v1/eventos/{id}

Detalle completo de un evento incluyendo artistas, servicios y documentos.

PUT/v1/eventos/{id}

Actualiza un evento. Solo se envian los campos a modificar.

DELETE/v1/eventos/{id}

Elimina un evento. Accion irreversible. Presupuestos y facturas asociados no se eliminan.

Clientes

GET/v1/clientes

Lista clientes con filtros por nombre, email, tipo y fecha. Paginacion incluida.

POST/v1/clientes

Crea un cliente. Requeridos: nombre, email. Opcionales: telefono, empresa, direccion, notas.

Artistas

GET/v1/artistas

Lista artistas y bandas. Filtros por genero, tipo (solista/banda), disponibilidad.

POST/v1/artistas

Registra artista o banda. Campos: nombre, tipo, genero, tarifa_hora, email, telefono.

Presupuestos

GET/v1/presupuestos

Lista presupuestos con filtros por estado (borrador, enviado, aceptado, rechazado), cliente y fecha.

POST/v1/presupuestos

Crea presupuesto con lineas de servicio, artista, duracion, precio e IVA. Asociable a evento y cliente.

Facturas

GET/v1/facturas

Lista facturas. Filtros por estado (pendiente, cobrada, vencida, rectificativa), cliente y fechas.

POST/v1/facturas

Genera factura desde presupuesto aceptado o manualmente con lineas de concepto.

Webhooks

Recibe notificaciones en tiempo real. Configura una URL de destino y selecciona los eventos.

Payload - evento.creado
{
  "evento": "evento.creado",
  "timestamp": "2026-03-22T14:30:00Z",
  "data": {
    "id": 48,
    "nombre": "Concierto Primavera 2026",
    "tipo": "concierto"
  }
}

Eventos disponibles

evento.creado
Se crea un nuevo evento
evento.actualizado
Se modifica un evento
evento.cancelado
Se cancela un evento
presupuesto.aceptado
Cliente acepta presupuesto
presupuesto.rechazado
Cliente rechaza presupuesto
factura.emitida
Se emite factura
factura.cobrada
Se registra cobro
artista.confirmado
Artista confirma asistencia

SDKs y Librerias

Librerias oficiales para integrar la API de forma rapida.

JavaScript / Node.js

Node.js 16+ y navegadores

npm install @gestonix/sdk

Python

Python 3.8+

pip install gestonix

PHP / Laravel

PHP 8.1+ y Laravel 10+

composer require gestonix/sdk
JavaScript - Ejemplo
import { Gestonix } from '@gestonix/sdk';

const client = new Gestonix('sk_live_tu_token');

// Listar proximos eventos
const eventos = await client.eventos.list({
  estado: 'confirmado',
  fecha_desde: '2026-04-01'
});

// Crear un nuevo evento
const nuevo = await client.eventos.create({
  nombre: 'Boda Lopez-Fernandez',
  tipo: 'boda',
  fecha: '2026-06-20',
  importe: 12000
});

Solicitar acceso a la API

Completa el formulario para solicitar tu token de acceso. Nuestro equipo revisara tu solicitud y te enviara las credenciales en 24-48 horas.