API-ul din spatele dashboard-ului Gomry.

REST prin HTTPS, chei API cu permisiuni pe resursă și notificări webhook pentru activitățile Gomry acceptate.

Creează o integrare care citește evenimente sau contacte ori creează înregistrări cu permisiunile acordate de tine. Echipa ta dezvoltă conexiunea la platforma Gomry existentă; API-ul nu este un serviciu de dezvoltare a sistemelor de ticketing la comandă.

Obține chei API Citește documentația

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());

De ce contează

Un singur API, cu tot cu dashboard.

API-ul acoperă space-uri, evenimente, experiențe, recurențe, clase de bilete, participanți, contacte, liste, formulare, răspunsuri trimise prin formulare, plăți și câmpuri personalizate. Cheile se creează în Setările organizației → API Keys.

Autentificare și scope-uri

Chei API trimise în header-ul X-API-KEY. Fiecare cheie are o hartă de scope-uri: none, read sau write per resursă. Orice limbaj peste HTTPS.

Opțiuni de livrare pentru webhookuri

Folosește abonamente webhook semnate, cu reîncercări, pentru evenimentele acceptate de înregistrare și răspuns la formulare sau URL-uri webhook legacy ale organizației, cu alte payloaduri și reguli de livrare.

Paginare și limite

Endpoint-urile cu liste paginate returnează informații despre pagini. Verifică limitele de răspuns ale fiecărui endpoint; limita este de 60 de solicitări la 10 secunde pe cheie API, cu aceeași limită pe adresă IP. Răspunsurile includ antete RateLimit, iar un 429 include Retry-After.

Alege cum primesc sistemele tale actualizările.

Configurează notificări pentru activitățile Gomry de care are nevoie integrarea ta. API-ul de abonamente webhook și URL-urile legacy din panou au tipuri de evenimente, payloaduri și reguli de livrare diferite.

Abonamente webhook semnate

Creează abonamente prin API sau lasă Zapier să le creeze pentru declanșatoarele sale instantanee. Alege evenimentele de înregistrare prin checkout sau de răspuns la formulare, cu filtru pentru eveniment sau formular unde este acceptat.

Payloadurile includ un ID de eveniment stabil. Antetele de livrare conțin o semnătură HMAC-SHA256. Expirarea timpului de așteptare, erorile de rețea și răspunsurile 429 sau 5xx declanșează reîncercări la intervale crescătoare. Celelalte răspunsuri 4xx nu. Evenimentele pot sosi de mai multe ori sau în altă ordine.

URL-uri webhook legacy ale organizației

Pentru integrările existente, adaugă URL-uri HTTPS în Organization Settings → API Keys → Webhooks. Fiecare URL primește evenimentele legacy acceptate ale organizației privind plățile, abonamentele și formularele.

Această cale folosește payloaduri legacy fără semnături sau reîncercări. Înainte de a acționa asupra datelor de plată sensibile, receptorul tău confirmă plata prin API.

Trimite înregistrările către CRM-ul pe care îl folosești deja

Pentru a adăuga în CRM participanții înregistrați prin checkout, dezvoltatorul tău pune la dispoziție un receptor HTTPS, verifică semnăturile abonamentelor și asociază datele participanților cu câmpurile API-ului CRM. Integrarea trebuie să gestioneze livrările repetate și să definească înregistrările de creat sau actualizat. Configurarea unei destinații webhook nu creează, în sine, o sincronizare continuă.

Configurarea și livrarea webhookurilor

Referință

Câteva dintre apelurile pe care le vei folosi.

Metodă	Endpoint	Rol
GET	/api/v1/events	Listează-ți evenimentele, cu paginare.
POST	/api/v1/events	Creează un eveniment.
GET	/api/v1/events/:id/attendees	Participanții unui eveniment, cu starea biletului.
GET	/api/v1/events/:id/ticket-classes	Tipuri de bilete cu preț și capacitate.
GET	/api/v1/payments	Plățile din întreaga organizație.
POST	/api/v1/contacts	Creează un contact.