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

REST sur HTTPS, clés API avec droits par ressource et notifications webhook pour les activités Gomry prises en charge.

Créez une intégration qui consulte les événements ou les contacts, ou crée des enregistrements avec les autorisations que vous accordez. Votre équipe développe la connexion à la plateforme Gomry existante ; l’API n’est pas un service de développement de billetterie sur commande.

Obtenir les clés API Lire la documentation

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.

Modes de livraison des webhooks

Utilisez des abonnements webhook signés avec nouvelles tentatives pour les événements pris en charge d’inscription et de réponse aux formulaires, ou des URL webhook historiques de l’organisation avec un payload et des règles de livraison différents.

Pagination et limites

Les endpoints de listes paginées renvoient les informations de pagination. Vérifiez les limites de réponse de chaque endpoint ; la limite est de 60 requêtes par 10 secondes par clé d’API, avec le même quota par adresse IP. Les réponses portent des en-têtes RateLimit, et une réponse 429 inclut Retry-After.

Choisissez comment vos systèmes reçoivent les mises à jour.

Configurez les notifications pour les activités Gomry dont votre intégration a besoin. L’API d’abonnements webhook et les URL historiques du tableau de bord ont des types d’événements, payloads et règles de livraison différents.

Abonnements webhook signés

Créez les abonnements via l’API, ou laissez Zapier les créer pour ses triggers instantanés. Choisissez les inscriptions via le checkout ou les événements de réponse aux formulaires, avec un filtre par événement ou formulaire lorsqu’il est pris en charge.

Les payloads portent un ID d’événement stable. Les en-têtes de livraison contiennent une signature HMAC-SHA256. Les délais dépassés, erreurs réseau et réponses 429 ou 5xx déclenchent de nouvelles tentatives avec des délais croissants. Les autres réponses 4xx ne sont pas retentées. Les événements peuvent arriver plusieurs fois ou dans le désordre.

URL webhook historiques de l’organisation

Pour les intégrations existantes, ajoutez des URL HTTPS dans Organization Settings → API Keys → Webhooks. Chaque URL reçoit les événements historiques pris en charge de l’organisation liés aux paiements, abonnements et formulaires.

Ce mécanisme utilise des payloads historiques sans signature ni nouvelle tentative. Avant d’agir sur des données de paiement sensibles, votre récepteur vérifie le paiement auprès de l’API.

Envoyez les inscriptions à votre CRM habituel

Pour ajouter à votre CRM les participants inscrits via le checkout, votre développeur fournit un récepteur HTTPS, vérifie les signatures des abonnements et fait correspondre les données des participants aux champs de l’API du CRM. L’intégration doit gérer les livraisons répétées et définir les enregistrements à créer ou modifier. Configurer une destination webhook ne crée pas à lui seul une synchronisation continue.

Configuration et livraison des webhooks

Référence

Quelques-uns des appels que vous utiliserez.

Méthode	Endpoint	Fonction
GET	/api/v1/events	Listez vos événements, avec pagination.
POST	/api/v1/events	Créez un événement.
GET	/api/v1/events/:id/attendees	Participants d’un événement, avec le statut du billet.
GET	/api/v1/events/:id/ticket-classes	Catégories de billets, avec prix et capacité.
GET	/api/v1/payments	Paiements de toute l’organisation.
POST	/api/v1/contacts	Créez un contact.