Die API hinter dem Gomry-Dashboard.

REST über HTTPS, API-Schlüssel mit Ressourcenrechten und Webhook-Benachrichtigungen für unterstützte Gomry-Aktivitäten.

Entwickle eine Integration, die Events oder Kontakte liest oder mit den von dir erteilten Berechtigungen Datensätze erstellt. Dein Team entwickelt die Verbindung zur bestehenden Gomry-Plattform. Die API ist kein Service für die Auftragsentwicklung eines Ticketing-Systems.

API-Schlüssel holen Dokumentation lesen

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, Experiences, 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.

Zustellwege für Webhooks

Nutze signierte Webhook-Abonnements mit erneuten Zustellversuchen für unterstützte Registrierungs- und Formularereignisse oder ältere Organisations-Webhook-URLs mit anderen Nutzdaten und Zustellregeln.

Paginierung und Limits

Paginierte Listen-Endpunkte liefern Seiteninformationen. Prüfe die Antwortlimits jedes Endpunkts; Das Rate-Limit beträgt 60 Anfragen pro 10 Sekunden pro API-Schlüssel, mit demselben Kontingent pro IP-Adresse. Antworten enthalten RateLimit-Header, und ein 429 enthält Retry-After.

Wähle, wie deine Systeme Updates erhalten.

Richte Benachrichtigungen für die Gomry-Aktivitäten ein, die deine Integration benötigt. Die API für Webhook-Abonnements und die älteren URL-Einstellungen im Dashboard haben unterschiedliche Ereignistypen, Nutzdaten und Zustellregeln.

Signierte Webhook-Abonnements

Erstelle Abonnements über die API oder lasse Zapier sie für seine Instant-Trigger anlegen. Wähle Registrierungen über den Checkout oder Formularantwort-Ereignisse und, soweit unterstützt, einen Filter für Veranstaltung oder Formular.

Die Nutzdaten enthalten eine stabile Ereignis-ID. Die Zustellheader enthalten eine HMAC-SHA256-Signatur. Bei Zeitüberschreitungen, Netzwerkfehlern sowie Antworten mit 429 oder 5xx wird die Zustellung mit wachsenden Abständen erneut versucht. Andere 4xx-Antworten lösen keine Wiederholung aus. Ereignisse können mehrfach oder in anderer Reihenfolge eintreffen.

Ältere Organisations-Webhook-URLs

Für bestehende Integrationen trägst du HTTPS-URLs unter Organization Settings → API Keys → Webhooks ein. Jede URL erhält die unterstützten älteren Zahlungs-, Abonnement- und Formularereignisse der Organisation.

Dieser Weg verwendet ältere Nutzdaten ohne Signaturen oder erneute Zustellversuche. Vor einer Aktion auf Grundlage sensibler Zahlungsdaten bestätigt dein Empfänger die Zahlung über die API.

Registrierungen an dein bestehendes CRM senden

Damit über den Checkout registrierte Teilnehmer in deinem CRM angelegt werden, stellt dein Entwickler einen HTTPS-Empfänger bereit, prüft die Abonnementsignaturen und ordnet Teilnehmerdaten den Feldern der CRM-API zu. Die Integration muss wiederholte Zustellungen behandeln und festlegen, welche Datensätze sie erstellt oder aktualisiert. Ein Webhook-Ziel allein richtet keinen kontinuierlichen Datenabgleich ein.

Einrichtung und Zustellung von Webhooks

Referenz

Ein paar der Aufrufe, die du nutzen wirst.

Methode	Endpoint	Funktion
GET	/api/v1/events	Liste deine Events auf, mit Paginierung.
POST	/api/v1/events	Lege ein Event an.
GET	/api/v1/events/:id/attendees	Teilnehmer eines Events mit Ticketstatus.
GET	/api/v1/events/:id/ticket-classes	Ticketklassen mit Preis und Kapazität.
GET	/api/v1/payments	Zahlungen der gesamten Organisation.
POST	/api/v1/contacts	Lege einen Kontakt an.