Fonctionnalité avancée : cette fonctionnalité est recommandée aux utilisateurs avancés uniquement et nécessite uncodage .

Qu'est-ce qu'un webhook ?

Un webhook est un moyen pour une application de fournir à d'autres applis des informations en temps réel. Un webhook transmet les données à d'autres applications au fur et à mesure, ce qui signifie que vous obtenez les données immédiatement. Cela diffère d'une API classique, dans laquelle vous devez interroger très fréquemment des données afin de les obtenir en temps réel. Cela rend les webhooks beaucoup plus efficaces et, dans la plupart des cas, c'est une meilleure option.

Quand devrais-je utiliser un webhook ?

Si vous souhaitez envoyer des données chaque fois qu'un nouveau ticket est acheté sur Universe sur votre serveur ou une autre application qui n'est pas prise en charge par notre intégration zapier, vous devez utiliser un webhook.

Quand ne devrais-je pas utiliser un webhook et utiliser l'API à la place ?

Si vous souhaitez uniquement que les données soient envoyées lorsque vous en faites la demande et si vous souhaitez vous limiter à la réception d'un sous-ensemble plus petit des données.

De quoi ai-je besoin pour utiliser un webhook ?

Pour utiliser un webhook, vous devez avoir quelque chose qui sera en mesure de consommer le webhook. Vous devrez donc être capable d'écrire du code ou de vous faire aider par quelqu'un qui l'est.

Que dois-je savoir sur un webhook Universe ?

Chaque fois qu'un ticket est acheté, nous enverrons une demande HTTP POSTcodée JSON à l' URL de charge utile fournie avec les en-têtes suivants :

X-Uniiverse-Event - Type d'événement

X-Uniiverse-Signature - Résumé hexadécimal HMAC de la charge utile, en utilisant le secret du hook comme clé (si elle est configurée).

Le corps de la demande sera une représentation des données codée JSON.

Commencer :

1. Configurer le webhook

Accédez à "Paramètres" dans votre compte Universe. 

2. Dans l'onglet "Compte", faites défiler jusqu'à la section webhooks et cliquez sur "Ajouter webhook".

3. Configurer le webhook

Pour configurer le webhook, vous devrez renseigner les champs suivants :

URL : il s’agira de l’URL de votre service Web ou de tout ce que vous avez configuré pour utiliser la demande POST.

Si vous souhaitez simplement le tester, vous pouvez utiliser un URL RequestBin (de https://requestbin.com/) comme emplacement pour envoyer temporairement les données de l'Universe et examiner le format de données

Secret : un secret est comme un mot de passe utilisé entre Universe et votre application pour empêcher les autres applis d'accéder à vos données.

Actif : vous devez cocher cette case si vous souhaitez activer le webhook. Vous pouvez activer et désactiver votre webhook à tout moment.

4. Écrire du code pour consommer les données

Chaque fois qu'un nouveau billet est acheté, Universe enverra toutes les données dont vous aurez besoin associées à l'événement et l'achat à renseigner dans votre application.

Vous pouvez voir un exemple de demande contenant toutes les données que nous envoyons ici.

Vous pouvez trouver une explication de chaque objet à http://developers.universe.com

Événements

Actuellement, il n'y a qu'un seul événement qui déclenche un webhook :

ticket_purchase - Chaque fois que vous achetez un billet ou qu'un billet est acheté pour l'une de vos annonces.

Dépannage

Si, pour une raison quelconque, la demande POST adressée à l'URL de charge utile échoue, le webhook sera marqué comme inactif et vous devrez le réactiver à partir de vos paramètres utilisateur.