API

Die API hinter dem Gomry-Dashboard.

REST über HTTPS, API-Schlüssel mit Scopes pro Ressource, Webhooks für Zahlungen, Formulare und Abonnements.

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());
Warum es zählt

Eine API, Dashboard inklusive.

Die API deckt Spaces, Events, Erlebnisse, Wiederholungen, Ticketklassen, Teilnehmer, Kontakte, Listen, Formulare, Bewerbungen, Zahlungen und eigene Felder ab. Schlüssel werden unter Organisationseinstellungen → API Keys erstellt.

Authentifizierung und Scopes

API-Schlüssel im Header X-API-KEY. Jeder Schlüssel trägt eine Scope-Map: none, read oder write pro Ressource. Jede Sprache über HTTPS.

Webhooks

Heute fünf Ereignistypen: Zahlung erfolgreich, Formularantwort erstellt und aktualisiert, Abonnement erstellt und gelöscht. Die Zustellung ist Best-Effort und unsigniert, also vor dem Handeln über die API bestätigen.

Paginierung und Limits

Seitenweise Auflistung in jeder Collection. Rate-Limits pro Schlüssel sind dokumentiert.

Referenz

Ein paar der Aufrufe, die du nutzen wirst.

POST
Deine Events auflisten, paginiert.
POST
Ein Event anlegen.
GET
Teilnehmer eines Events, mit Ticketstatus.
POST
Ticketklassen mit Preis und Kapazität.
POST
Zahlungen der gesamten Organisation.
Einen Kontakt anlegen.
Schlüssel erstellen und den ersten Aufruf machen.