API

L'API dietro la dashboard di Gomry.

REST su HTTPS, chiavi API con scope per risorsa, webhook per pagamenti, form e abbonamenti.

events.tswebhooks.ts
// List your events. Same endpoint the dashboard uses.
const res = await fetch(
  "https://www.gomry.com/api/v1/events?page=1&page_size=20",
  { headers: { "X-API-KEY": process.env.GOMRY_API_KEY } }
);
const { data, pagination } = await res.json();

// Attendees for the first event.
const attendees = await fetch(
  `https://www.gomry.com/api/v1/events/${data[0].id}/attendees`,
  { headers: { "X-API-KEY": process.env.GOMRY_API_KEY } }
).then(r => r.json());
Perché è importante

Una sola API, dashboard inclusa.

L'API copre space, eventi, esperienze, ricorrenze, classi di biglietto, partecipanti, contatti, liste, form, candidature, pagamenti e campi personalizzati. Le chiavi si creano in Impostazioni organizzazione → API Keys.

Autenticazione e scope

Chiavi API inviate nell'header X-API-KEY. Ogni chiave ha una mappa di scope: none, read o write per risorsa. Qualsiasi linguaggio su HTTPS.

Webhook

Cinque tipi di evento oggi: pagamento riuscito, risposta a un form creata e aggiornata, abbonamento creato ed eliminato. La consegna è best-effort e non firmata: verifica tramite l'API prima di agire.

Paginazione e limiti

Elenchi paginati su ogni collezione. I limiti di frequenza per chiave sono documentati.

Riferimento

Alcune delle chiamate che userai.

POST
Elenca i tuoi eventi, con paginazione.
POST
Crea un evento.
GET
Partecipanti di un evento, con stato del biglietto.
POST
Classi di biglietto con prezzo e capienza.
POST
Pagamenti di tutta l'organizzazione.
Crea un contatto.
Crea una chiave e fai la prima chiamata.