وبهوک
وبهوک (Webhook) درخواست HTTP است که سرویس هنگام رخ دادن رویداد، خودش به URLی که از قبل ثبت کردهاید میفرستد: رسیدن پیام، موفق شدن پرداخت، تغییر وضعیت. بهجای اینکه خودتان مدام درخواست بفرستید، سرور شما درخواست دریافت میکند.
وبهوک چگونه کار میکند
یک URL عمومی HTTPS ثبت میکنید؛ وقتی رویداد رخ میدهد، سرویس درخواست POST با بدنهٔ JSON به آن میفرستد و سرور شما با کد 2xx پاسخ میدهد. Telegram Bot API همینطور کار میکند: بعد از فراخوانی setWebhook هر بهروزرسانی ربات بهصورت HTTPS POST به URL شما میرسد. اگر پاسخ 2xx نباشد، Telegram درخواست را تکرار میکند و بعد از چند تلاش متوقف میشود (مستندات Telegram Bot API).
URL عمومی است، پس درخواستهای ورودی باید بررسی شوند. Telegram مقدار پارامتر secret_token را در هدر X-Telegram-Bot-Api-Secret-Token میگذارد؛ درخواست بدون آن را رد کنید. پولینگ با getUpdates و وبهوک همزمان کار نمیکنند: Telegram فقط یک راه دریافت بهروزرسانی را مجاز میداند.
وبهوک یا پولینگ: یک مثال
مثال فرضی: رویدادی روزی 5 بار رخ میدهد. پولینگ هر 10 ثانیه یعنی 24 × 3,600 ÷ 10 = 8,640 درخواست در روز که فقط 5 تای آن خبر تازه دارد. وبهوک در همان روز 5 درخواست است، یکی برای هر رویداد.
در عوض وبهوک به سروری با URL عمومی نیاز دارد که شبانهروز درخواست بپذیرد. اگر سرور شما بیشتر از مدتی که سرویس تلاش مجدد میکند از کار بیفتد، ممکن است رویداد را از دست بدهید.
Genesis API وبهوک ندارد
Genesis API داده را فقط بنا بر درخواست میدهد: هر فراخوانی یک HTTP GET است (مستندات) و نه وبهوکی هست و نه WebSocket. برای باخبر شدن فوری از فرصتها دو راه هست.
بدون کد: اعلانهای Telegram. Genesis Arbitrage سیگنالهای دستهها و فیلترهای انتخابی شما را به ربات Telegram خودتان میفرستد. ربات شخصی با اشتراک Pro سایت در دسترس است و راهاندازی در راهنما توضیح داده شده است.
با کد: Genesis API را بهاندازهٔ تازگی پلن پولینگ کنید (گام در پلنها و محدودیتها آمده است) و وقتی فرصتی پیدا شد برای خودتان پیام بفرستید. ربات آربیتراژ ارز دیجیتال با Python همینطور کار میکند.
همچنین ببینید: API، REST API، تأخیر.
پرسش و پاسخ
آیا Genesis API میتواند داده را به وبهوک بفرستد؟
خیر، Genesis API فقط به درخواست کلاینت پاسخ میدهد. برای هشدار آماده بدون کد خودتان از اعلانهای Telegram در Genesis Arbitrage استفاده کنید.