Webhook
Un webhook est une requête HTTP qu’un service envoie de lui-même à une URL que vous avez enregistrée à l’avance lorsqu’un événement se produit : un message arrive, un paiement passe, un statut change. Au lieu d’envoyer des requêtes répétées, votre serveur en reçoit.
Comment fonctionne un webhook
Vous enregistrez une URL HTTPS publique ; lorsqu’un événement se produit, le service y envoie une requête POST avec un corps JSON, et votre serveur répond par un code 2xx. L’API Telegram Bot fonctionne ainsi : après un appel à setWebhook, chaque mise à jour du bot arrive en POST HTTPS sur votre URL. Si la réponse n’est pas 2xx, Telegram répète la requête et s’arrête après plusieurs tentatives (documentation de l’API Telegram Bot).
L’URL est publique : il faut donc vérifier les requêtes entrantes. Telegram place la valeur du paramètre secret_token dans l’en-tête X-Telegram-Bot-Api-Secret-Token ; rejetez les requêtes qui n’en ont pas. Le polling avec getUpdates et un webhook ne fonctionnent pas en même temps : Telegram n’autorise qu’un seul moyen de recevoir les mises à jour.
Webhook ou polling : un exemple
Exemple hypothétique : un événement survient 5 fois par jour. Un polling toutes les 10 secondes représente 24 × 3 600 ÷ 10 = 8 640 requêtes par jour, dont 5 seulement apportent une nouveauté. Un webhook en demande 5 sur la même journée, une par événement.
En contrepartie, un webhook exige un serveur avec une URL publique qui accepte des requêtes 24 h/24. Si votre serveur est hors service plus longtemps que le service ne réessaie, vous pouvez manquer l’événement.
Genesis API n’a pas de webhooks
Genesis API ne sert des données que sur demande : chaque appel est un HTTP GET (documentation), et il n’y a ni webhooks ni WebSocket. Il existe deux façons d’être averti tout de suite des opportunités.
Sans code : les notifications Telegram. Genesis Arbitrage envoie les signaux de vos catégories et filtres choisis à votre propre bot Telegram. Le bot personnel est disponible avec l’abonnement Pro du site, et la configuration est décrite dans le guide.
Avec du code : interrogez Genesis API à la fraîcheur de votre plan (le pas figure dans Plans et limites) et envoyez-vous un message lorsqu’une opportunité apparaît. C’est ainsi que fonctionne le bot d’arbitrage crypto en Python.
Voir aussi : API, API REST, latence.
Questions et réponses
Genesis API peut-elle envoyer des données à un webhook ?
Non, Genesis API ne fait que répondre aux requêtes du client. Pour des alertes toutes prêtes sans code, utilisez les notifications Telegram de Genesis Arbitrage.