Característica avanzada: esta característica se recomienda solo para usuarios avanzados y requierecodificación .

¿Qué es un webhook?

Un webhook es una forma en la que una aplicación proporciona información en tiempo real a otras aplicaciones. Un webhook entrega datos a otras aplicaciones a medida que ocurren, lo que significa que obtienes datos inmediatamente. Esto es diferente de una API típica, en la que necesitas sondear los datos con mucha frecuencia para obtenerlos en tiempo real. Esto hace que los webhooks sean mucho más eficientes, y en la mayoría de los casos, una mejor opción.

¿Cuándo debo usar un webhook?

Si deseas enviar datos cada vez que compres un nuevo ticket en Universe a tu servidor u otra aplicación que no sea compatible a través de nuestra integración de Zapier, entonces debes usar un webhook.

¿Cuándo no debería usar un webhook en lugar de la API?

Si solo deseas que los datos se envíen cuando inicias la solicitud, y deseas limitarte a recibir solo un subconjunto más pequeño de los datos.

¿Qué necesito para usar un webhook?

Para utilizar un webhook, deberás tener algo que pueda consumir el webhook. Por lo tanto, necesitarás escribir algún código u obtener ayuda de alguien que lo haga.

¿Qué necesito saber sobre un webhook Universe?

Siempre que se compre un boleto, enviaremos una solicitud POSTHTTP codificada por JSON a la URL de carga útil provista con los siguientes encabezados:

X-Uniiverse-Evento - Tipo de evento

X-Uniiverse-Firma:  resumen de HMAC de la carga útil, utilizando el secreto del gancho como clave (si está configurado).

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

Empezar:

1. Configurar el webhook

Ve a 'Configuración' en tu Cuenta Universe. 

2. En la pestaña 'cuenta', desplázate hacia abajo hasta la sección de Webhooks y haz clic en 'Agregar Webhook'

3. Configurar el Webhook

Para configurar el webhook, deberás completar los siguientes campos:

URL: esta será la URL de tu servicio web o lo que hayas configurado para consumir la solicitud POST.

Si solo quieres probarlo, puedes usar una URL RequestBin (desde https://requestbin.com/) como un lugar para enviar temporalmente los datos del Universe y examinar el formato de los datos.

Secreto: un secreto es como una contraseña utilizada entre Universe y tu aplicación, para evitar que otras aplicaciones accedan a tus datos.

Activo: debes marcar esta casilla si desea activar el webhook. Puedes habilitar y deshabilitar tu webhook en cualquier momento.

4. Escribir código para consumir los datos.

Cada vez que se compra un nuevo boleto, Universe enviará todos los datos que necesitarás asociados con el evento y la compra para completar en tu aplicación.

Puedes ver una solicitud de muestra que contiene todos los datos que enviamos aquí.

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

Eventos

Actualmente, solo hay un evento que activa un webhook:

compra_de entradas - Cada vez que compras una entrada, o se compra una entrada de uno de tus listados.

Resolución de Problemas

Si, por algún motivo, la solicitud POST a la URL de la carga útil falla, el webhook se marcará como inactivo y tendrás que volver a habilitarlo desde la configuración del usuario.