API

API-ul din spatele dashboard-ului Gomry.

REST peste HTTPS, chei API cu scope-uri per resursă, webhook-uri pentru plăți, formulare și abonamente.

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, aplicații, 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.

Webhook-uri

Cinci tipuri de evenimente azi: plată reușită, răspuns la formular creat și actualizat, abonament creat și șters. Livrarea e best-effort și nesemnată, deci confirmă prin API înainte de a acționa.

Paginare și limite

Listare paginată pe fiecare colecție. Limitele de rată per cheie sunt documentate.

Referință

Câteva dintre apelurile pe care le vei folosi.

POST
Listează-ți evenimentele, cu paginare.
POST
Creează un eveniment.
GET
Participanții unui eveniment, cu starea biletului.
POST
Clase de bilete cu preț și capacitate.
POST
Plățile din întreaga organizație.
Creează un contact.
Creează o cheie și fă primul apel.