Secret keys y Organizer API

Usa secret keys para integraciones server-to-server.

Crear una secret key en WODira

Usa secret keys solo en backends de confianza. Nunca las incluyas en bundles frontend, HTML, apps móviles públicas ni repositorios.

1. En WODira, entra en Perfil de organización → API.
2. En Nueva clave, selecciona Secret key (backend).
3. Escribe un nombre reconocible, por ejemplo backend producción o sync CRM.
4. Selecciona solo los scopes necesarios para esa integración.
5. Opcionalmente añade fecha de caducidad.
6. Pulsa Crear clave.
7. Copia la clave wd_live_... inmediatamente y guárdala en un secret manager o variable de entorno.

Ejemplo recomendado:

WODIRA_API_KEY=wd_live_...

Si una secret key se filtra o ya no se usa, revócala desde Claves existentes y crea una nueva.

Scopes

Scope	Permiso
events:read	Leer eventos, categorías, campos, waivers, sponsors y suplementos activos.
pricing:read	Leer cards de tarifas, cupos y precio activo.
registrations:read	Buscar inscripciones.
registrations:write	Crear, actualizar y cancelar inscripciones.

Endpoints

Cada método tiene ejemplos equivalentes con @wodira/sdk, curl y PHP sin SDK.

Método	Ruta	Scope	Ejemplos
POST	/events/search	events:read	searchEvents
GET	/events/:eventId	events:read	getEvent
GET	/events/:eventId/pricing-cards	pricing:read	getPricingCards
POST	/registrations	registrations:write	createRegistration
POST	/registrations/search	registrations:read	searchRegistrations
PATCH	/registrations/:ticketId	registrations:write	updateRegistration
DELETE	/registrations/:ticketId	registrations:write	deleteRegistration

Ejemplo

import { createWodiraClient } from '@wodira/sdk';

const wodira = createWodiraClient({ apiKey: process.env.WODIRA_API_KEY! });
const events = await wodira.searchEvents({ status: 'PUBLISHED', limit: 20 });