Genesis Arbitrage

Genesis Arbitrage · · 2 min de leitura

Webhook

Um webhook é uma requisição HTTP que um serviço envia por conta própria a uma URL que você registrou antes, quando um evento acontece: chega uma mensagem, um pagamento é aprovado, um status muda. Em vez de fazer requisições repetidas, seu servidor recebe requisições de entrada.

Como um webhook funciona

Você registra uma URL HTTPS pública; quando um evento acontece, o serviço envia a ela uma requisição POST com corpo JSON, e seu servidor responde com um código 2xx. A Telegram Bot API funciona assim: após uma chamada a setWebhook, cada atualização do bot chega como um POST HTTPS na sua URL. Se a resposta não for 2xx, o Telegram repete a requisição e para após várias tentativas (documentação da Telegram Bot API).

A URL é pública, então as requisições recebidas precisam ser verificadas. O Telegram coloca o valor do parâmetro secret_token no cabeçalho X-Telegram-Bot-Api-Secret-Token; rejeite as requisições sem ele. O polling com getUpdates e um webhook não funcionam ao mesmo tempo: o Telegram permite só uma forma de receber atualizações.

Webhook ou polling: um exemplo

Exemplo hipotético: um evento acontece 5 vezes por dia. Consultar a cada 10 segundos dá 24 × 3.600 ÷ 10 = 8.640 requisições por dia, e só 5 trazem novidade. Um webhook usa 5 requisições no mesmo dia, uma por evento.

Em troca, o webhook exige um servidor com URL pública que aceite requisições 24 horas por dia. Se seu servidor ficar fora do ar por mais tempo do que o serviço continua tentando, você pode perder o evento.

A Genesis API não tem webhooks

A Genesis API serve dados só sob demanda: toda chamada é um HTTP GET (documentação), e não há webhooks nem WebSocket. Há duas formas de saber das oportunidades na hora.

Sem código: as notificações do Telegram. A Genesis Arbitrage envia os sinais das categorias e filtros que você escolher para o seu próprio bot do Telegram. O bot pessoal está disponível na assinatura Pro do site, e a configuração está descrita no guia.

Com código: consulte a Genesis API na atualidade do seu plano (o passo está em Planos e limites) e envie uma mensagem a si mesmo quando surgir uma oportunidade. É assim que funciona o bot de arbitragem de criptomoedas em Python.

Veja também: API, API REST, latência.

Perguntas e respostas

A Genesis API pode enviar dados a um webhook?

Não, a Genesis API só responde às requisições do cliente. Para alertas prontos sem código próprio, use as notificações do Telegram da Genesis Arbitrage.