Función avanzada: Esta función se recomienda solo para usuarios avanzados y requiere codificación.

¿Qué es un webhook?

Un webhook es una forma de que una aplicación facilite información en tiempo real a otras aplicaciones. Un webhook entrega datos a otras aplicaciones a medida que se producen, lo que significa que usted recibe los datos inmediatamente. Esto difiere de una API típica, en la que es necesario sondear los datos con mucha frecuencia para recibirlos en tiempo real. Por ello, los webhooks son mucho más eficaces y, en la mayoría de los casos, una mejor opción.

¿Cuándo debo utilizar un webhook?

Si desea enviar datos cada vez que se compre un nuevo boleto en Universe a su servidor o a otra aplicación que no sea compatible con nuestra integración Zapier, entonces deberá utilizar un webhook.

¿Cuándo no debo utilizar un webhook y debo utilizar la API en su lugar?

Si solo desea que los datos se envíen cuando inicie la solicitud y quiere limitarse a recibir solo un subconjunto más pequeño de los datos.

¿Qué necesito para utilizar un webhook?

Para poder utilizar un webhook, necesitará tener algo que sea capaz de consumir el webhook. Así que tendrá que escribir algo de código o conseguir ayuda de alguien que sepa hacerlo.

¿Qué necesito saber sobre un webhook de Universe?

Cada vez que se compre un boleto, enviaremos una solicitud HTTP POST codificada en JSONa la URL de carga útil facilitada con las siguientes cabeceras:

X-Uniiverse-Event: Tipo de evento

X-Uniiverse-Signature: Resumen hexadecimal HMAC de la carga útil, utilizando Hook Secrets como clave (si está configurado).

El cuerpo de la solicitud será una representación codificada en JSONde los datos.

Cómo empezar:

1. Configure el webhook

Navegue hasta «Settings» en su Cuenta Universe. 

2. En la pestaña «Account», baje hasta la sección webhooks y haga clic en «Add webhook»

3. Configure el webhook

Para configurar el webhook, deberá rellenar los siguientes campos:

URL: Será la URL de su servicio web o lo que haya configurado para consumir la solicitud POST.

Si solo quiere probarlo, puede utilizar una URL RequestBin (de https://requestbin.com/) como lugar para enviar temporalmente los datos de Universe y examinar el formato de los datos

Secret: Un secret es como una contraseña que utiliza Universe y su aplicación para evitar que otras aplicaciones accedan a los datos.

Active: Debe marcar esta casilla si desea activar el webhook. Puede activar y desactivar el webhook en cualquier momento.

4. Escriba el código para consumir los datos

Cada vez que se compre un nuevo boleto, Universe le enviará todos los datos que necesitará asociados al evento y a la compra para que se incluyan en su aplicación.

Puede ver un ejemplo de solicitud con todos los datos que enviamos aquí.

Puede encontrar una explicación de cada objeto en http://developers.universe.com

Eventos

Actualmente, hay dos eventos que activan un webhook:

ticket_purchase: Cada vez que usted compra una entrada o cada vez que se compra una entrada en uno de sus listados.

ticket_update: Cada vez que cambia el estado de la entrada (por ejemplo, de pagada a cancelada, etc.).

Nota: Estos eventos comparten la misma carga útil de datos.

Solución de problemas

Si por alguna razón falla la solicitud POST a la URL de carga útil, el webhook se marcará como inactivo y tendrá que volver a activarlo desde la configuración de usuario.