L'API dietro la dashboard di Gomry.

REST su HTTPS, chiavi API con permessi per risorsa e notifiche webhook per le attività Gomry supportate.

Crea un’integrazione che legga eventi o contatti, oppure crei record con i permessi che concedi. Il tuo team sviluppa il collegamento alla piattaforma Gomry esistente; l’API non è un servizio di sviluppo di sistemi di biglietteria su commissione.

Ottieni le chiavi API Leggi la documentazione

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.

Modalità di consegna dei webhook

Usa webhook subscriptions firmate con nuovi tentativi di consegna per gli eventi supportati di registrazione e risposta ai moduli, oppure URL webhook legacy dell’organizzazione con payload e modalità di consegna diversi.

Paginazione e limiti

Gli endpoint con elenchi paginati restituiscono informazioni sulle pagine. Controlla i limiti di risposta di ciascun endpoint; il limite è di 60 richieste ogni 10 secondi per chiave API, con lo stesso margine per indirizzo IP. Le risposte includono le intestazioni RateLimit, e un 429 include Retry-After.

Scegli come ricevere gli aggiornamenti nei tuoi sistemi.

Configura le notifiche per le attività Gomry necessarie alla tua integrazione. L’API delle webhook subscriptions e le impostazioni URL legacy della dashboard hanno tipi di evento, payload e regole di consegna diversi.

Webhook subscriptions firmate

Crea le subscriptions tramite API, oppure lascia che Zapier le crei per i suoi trigger istantanei. Scegli registrazioni tramite checkout o eventi di risposta ai moduli, con filtro per evento o modulo dove supportato.

I payload includono un ID evento stabile. Gli header della consegna contengono una firma HMAC-SHA256. Timeout, errori di rete e risposte 429 o 5xx attivano nuovi tentativi con attese crescenti. Le altre risposte 4xx non li attivano. Gli eventi possono arrivare più volte o fuori ordine.

URL webhook legacy dell’organizzazione

Per le integrazioni esistenti, aggiungi URL HTTPS in Organization Settings → API Keys → Webhooks. Ogni URL riceve gli eventi legacy supportati dell’organizzazione relativi a pagamenti, abbonamenti e moduli.

Questo percorso usa payload legacy senza firma né nuovi tentativi di consegna. Prima di agire su dati di pagamento sensibili, il tuo endpoint verifica il pagamento tramite API.

Invia le registrazioni al CRM che usi già

Per aggiungere al CRM i partecipanti che si registrano tramite checkout, chi sviluppa l’integrazione prepara un endpoint HTTPS, verifica le firme delle subscriptions e associa i dati dei partecipanti ai campi dell’API del CRM. L’integrazione deve gestire le consegne ripetute e definire quali record creare o aggiornare. Impostare una destinazione webhook non crea di per sé una sincronizzazione continua.

Configurazione e consegna dei webhook

Riferimento

Alcune delle chiamate che userai.

Metodo	Endpoint	Funzione
GET	/api/v1/events	Elenca i tuoi eventi, con paginazione.
POST	/api/v1/events	Crea un evento.
GET	/api/v1/events/:id/attendees	Partecipanti di un evento, con stato del biglietto.
GET	/api/v1/events/:id/ticket-classes	Classi di biglietto con prezzo e capienza.
GET	/api/v1/payments	Pagamenti di tutta l’organizzazione.
POST	/api/v1/contacts	Crea un contatto.