Inicio rápido

En 5 minutos: crea una clave de prueba y publica tu primer evento con una sola petición idempotente.

1. Crea una clave

  1. Entra en Mi empresa → Integraciones. Tienes que ser owner o admin de la empresa.
  2. Pon un nombre, marca Puede crear, editar y cancelar eventos y elige el modo Prueba.
  3. Copia la clave rk_test_…. Se muestra una sola vez: guárdala como un secreto, en tu servidor, nunca en el navegador.

Lo que crea una clave de prueba no es público y se borra a los 7 días. Cuando todo funcione, crea una clave Real (rk_live_…) y repite.

bash
export REMOLOM_KEY=rk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. Publica un evento (upsert)

PUT /v1/events/external/:source/:externalId crea el evento si no existe (201) y lo actualiza si ya existe (200). Usa el id del evento en tu sistema como externalId: puedes repetir la petición sin crear duplicados.

bash
curl -X PUT https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05 \
  -H "Authorization: Bearer $REMOLOM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Concierto de jazz",
    "categories": ["musica"],
    "startsAt": "2026-12-05T21:00",
    "venueName": "Sala Clamores",
    "address": "Calle Alburquerque 14, Madrid",
    "isFree": false,
    "prices": [{ "name": "General", "priceCents": 1850 }],
    "currency": "EUR",
    "ticketUrl": "https://mi-web.com/entradas/jazz"
  }'
js
// Node 18+ (fetch nativo)
const res = await fetch('https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05', {
  method: 'PUT',
  headers: { Authorization: `Bearer ${process.env.REMOLOM_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    title: 'Concierto de jazz',
    categories: ['musica'],
    startsAt: '2026-12-05T21:00',
    venueName: 'Sala Clamores',
    address: 'Calle Alburquerque 14, Madrid',
    isFree: false,
    prices: [{ name: 'General', priceCents: 1850 }],
    currency: 'EUR',
  }),
})
const { event, error } = await res.json()
console.log(res.status, event?.id ?? error) // 201 la primera vez, 200 después
python
import os, requests

r = requests.put(
    "https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05",
    headers={"Authorization": f"Bearer {os.environ['REMOLOM_KEY']}"},
    json={
        "title": "Concierto de jazz",
        "categories": ["musica"],
        "startsAt": "2026-12-05T21:00",
        "venueName": "Sala Clamores",
        "address": "Calle Alburquerque 14, Madrid",
        "isFree": False,
        "prices": [{"name": "General", "priceCents": 1850}],
        "currency": "EUR",
    },
)
print(r.status_code, r.json())

La respuesta es { "event": EventDTO } con el id de Remolom, las fechas en UTC y "test": true si usaste una clave de prueba.

3. Comprueba y cancela

bash
curl https://remolom.com/api/v1/events -H "Authorization: Bearer $REMOLOM_KEY"

curl -X DELETE https://remolom.com/api/v1/events/external/mi-web/jazz-2026-12-05 \
  -H "Authorization: Bearer $REMOLOM_KEY"

DELETE cancela el evento, no lo borra. Un PUT posterior con el mismo externalId lo reactiva.

Siguientes pasos