Webhook
Un webhook es una petición HTTP que un servicio envía por su cuenta a una URL que registraste de antemano cuando ocurre un evento: llega un mensaje, se completa un pago, cambia un estado. En lugar de hacer peticiones repetidas, tu servidor recibe peticiones entrantes.
Cómo funciona un webhook
Registras una URL HTTPS pública; cuando ocurre un evento, el servicio envía a esa URL una petición POST con un cuerpo JSON y tu servidor responde con un código 2xx. Así funciona la Telegram Bot API: tras una llamada a setWebhook, cada actualización del bot llega como un POST HTTPS a tu URL. Si la respuesta no es 2xx, Telegram repite la petición y se detiene tras varios intentos (documentación de la Telegram Bot API).
La URL es pública, así que hay que verificar las peticiones entrantes. Telegram pone el valor del parámetro secret_token en el encabezado X-Telegram-Bot-Api-Secret-Token; rechaza las peticiones que no lo traigan. El polling con getUpdates y un webhook no funcionan a la vez: Telegram admite una sola forma de recibir actualizaciones.
Webhook o polling: un ejemplo
Ejemplo hipotético: un evento ocurre 5 veces al día. Consultar cada 10 segundos son 24 × 3600 ÷ 10 = 8640 peticiones al día, y solo 5 traen novedades. Un webhook necesita 5 peticiones en el mismo día, una por evento.
A cambio, un webhook requiere un servidor con URL pública que acepte peticiones las 24 horas. Si tu servidor está caído más tiempo del que el servicio sigue reintentando, puedes perder el evento.
Genesis API no tiene webhooks
Genesis API sirve datos solo bajo petición: cada llamada es un HTTP GET (documentación), y no hay webhooks ni WebSocket. Hay dos formas de enterarse de las oportunidades al momento.
Sin código: las notificaciones de Telegram. Genesis Arbitrage envía las señales de las categorías y filtros que elijas a tu propio bot de Telegram. El bot personal está disponible con la suscripción Pro del sitio, y la configuración se describe en la guía.
Con código: consulta Genesis API a la frescura de tu plan (el paso figura en Planes y límites) y envíate un mensaje cuando aparezca una oportunidad. Así funciona el bot de arbitraje cripto en Python.
Véase también: API, API REST, latencia.
Preguntas y respuestas
¿Puede Genesis API enviar datos a un webhook?
No, Genesis API solo responde a las peticiones del cliente. Para alertas listas sin código propio, usa las notificaciones de Telegram de Genesis Arbitrage.