Skip to content

Winglark

Pour commencer

API et webhooks

En service

Une API de gestion d’événements avec des webhooks signés.

Lisez événements, invités, réponses et entrées, ajoutez et modifiez des invités depuis vos propres systèmes, et recevez un message signé dès qu’il se passe quelque chose à l’événement.

Demander un accèsOuvrir la référence développeur
  • API REST v1
  • Treize événements webhook
  • Professional et Agency
Un webhook rsvp.submitted, tel que votre point de terminaison le reçoit
POST /winglark HTTP/1.1
Winglark-Signature: t=1762338012,v1=5f2b…c9e1
Winglark-Event: rsvp.submitted
Winglark-Delivery: 7c1e9a42-…

{
  "type": "rsvp.submitted",
  "created_at": "2026-11-05T18:40:12.481Z",
  "event_id": "6f1c2a7e-…",
  "data": {
    "response": "yes",
    "party_size": 2,
    "guest": { "first_name": "Ada", "email": "a•••@example.com" }
  }
}

Les coordonnées restent masquées tant que le point de terminaison n’est pas autorisé à les voir.

Ce qu’elle fait

Vos systèmes, tenus à jour par l’événement lui-même.

Tout ce qui suit fonctionne aujourd’hui dans les offres Professional et Agency.

Lire l’événement
Événements, invités, réponses et entrées, paginés par curseur pour qu’une grande liste arrive par morceaux.
Écrire la liste
Ajouter ou modifier des invités depuis une billetterie, un CRM ou un formulaire. Une clé d’idempotence rend une nouvelle tentative sans effet.
L’apprendre sur le moment
Des webhooks pour les réponses, les invitations, l’entrée, les billets, le plan de table et les badges, signés avec un horodatage.
Voir chaque envoi
Un journal avec chaque statut et tentative, le renvoi, un événement de test et la mise en pause des adresses en échec.

Comment ça marche

Trois étapes.

  1. Créer une cléDans Intégrations, choisissez ses droits et, si vous le souhaitez, une date d’expiration. Copiez-la : elle n’est affichée qu’une fois.
  2. Ajouter un point de terminaisonIndiquez l’adresse HTTPS et les événements à entendre. Envoyez un test pour vérifier la signature.
  3. Construire dessusAppelez l’API avec la clé et agissez sur chaque webhook. La référence développeur donne chaque route et chaque champ.

Dans le produit

Clés, webhooks et chaque envoi, sur un seul écran.

Les intégrations se trouvent dans les réglages de l’espace de travail. Une clé est créée avec les droits nécessaires et affichée une fois ; un point de terminaison reçoit les événements qu’il doit entendre ; le journal des envois montre ce qui est parti, ce qui est revenu et ce qui est retenté.

Espace de travail, clés et envois fictifs. Les écrans sont dessinés d’après le produit tel qu’il fonctionne.

API et webhooksEn service

Ce qu’il vous faut

Un espace de travail en offre Professional ou Agency, et quelqu’un capable de recevoir une requête HTTPS. Free, Starter et Single Event n’incluent pas l’API.

Ouvrir la référence développeur →Intégrations →Comparer les offres →

Les événements auxquels un point de terminaison peut s’abonner

  • guest.created
  • guest.updated
  • guest.archived
  • rsvp.submitted
  • invitation.sent
  • invitation.delivered
  • invitation.bounced
  • checkin.admitted
  • ticket.issued
  • event.published
  • event.cancelled
  • seatmap.published
  • badge.printed

Questions

Existe-t-il une API REST pour les listes d’invités ?

Oui : lister, lire, créer et modifier les invités par événement, et lire réponses et entrées. Les réponses sont en JSON, les listes paginées par curseur, et les créations acceptent une clé d’idempotence.

Comment les webhooks sont-ils signés ?

Par un HMAC sur un horodatage et le contenu brut, envoyé dans l’en-tête Winglark-Signature. Lors d’un changement de secret, l’ancien reste valable pendant un chevauchement : rien ne se perd pendant la bascule.

Y a-t-il des limites de débit ?

Oui, par clé. Une requête au-delà de la limite reçoit le statut 429 et peut être répétée après le délai indiqué dans la réponse.

Peut-on limiter une clé à la lecture ?

Oui. Une clé ne porte que les droits avec lesquels elle a été créée — par exemple lire les événements et les réponses, sans rien écrire.

Donnez une clé à vos systèmes.

Dans Professional et Agency, depuis les réglages de l’espace de travail.

Demander un accèsOuvrir la référence développeur