API

L'API derrière le tableau de bord Gomry.

REST sur HTTPS, clés API avec scopes par ressource, webhooks pour les paiements, formulaires et 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());
Pourquoi c'est important

Une seule API, tableau de bord compris.

L'API couvre les spaces, événements, expériences, récurrences, catégories de billets, participants, contacts, listes, formulaires, candidatures, paiements et champs personnalisés. Les clés se créent dans Paramètres de l'organisation → API Keys.

Authentification et scopes

Clés API envoyées dans l'en-tête X-API-KEY. Chaque clé porte une carte de scopes : none, read ou write par ressource. N'importe quel langage sur HTTPS.

Webhooks

Cinq types d'événements aujourd'hui : paiement réussi, réponse à un formulaire créée et mise à jour, abonnement créé et supprimé. La livraison est best-effort et non signée : vérifiez via l'API avant d'agir.

Pagination et limites

Listes paginées sur chaque collection. Les limites de débit par clé sont documentées.

Référence

Quelques-uns des appels que vous utiliserez.

POST
Listez vos événements, avec pagination.
POST
Créer un événement.
GET
Participants d'un événement, avec le statut du billet.
POST
Catégories de billets avec prix et capacité.
POST
Paiements de toute l'organisation.
Créer un contact.
Créez une clé et faites le premier appel.