getUpdates

متد

از این متد برای دریافت آپدیت‌ها با استفاده از long polling استفاده کنید. این متد آرایه‌ای از Update را باز می‌گرداند.

نکته: به منظور جلوگیری از Update های تکراری، مقدار offset را بعد از هر پاسخ سرور، مجدد حساب کنید.

پارامترها

نامنوعالزامتوضیحات
offsetIntegerاختیاریشناسه اولین آپدیتی که باید برگردانده شود. باید یک واحد بیشتر از بیشترین مقدار شناسه‌های مربوط به Update های دریافتی قبلی باشد. به طور پیش‌فرض، ابتدا Update هایی بازگشت داده می شوند که اولین Update تایید نشده را دارند . به محض اینکه getUpdates با یک offset بیشتر از update_id خود فراخوانی شود، Update به صورت تایید شده در نظر گرفته خواهد شد. از مقدار offset منفی هم می‌توان استفاده کرد. از مقدار منفی offset میتوان برای دریافت Update ها از انتهای صف Update ها استفاده کرد. تمام Update های قبلی فراموش خواهند شد.
limitIntegerاختیاریحداکثر تعداد آپدیت‌هایی که باید بازگردانده شوند. مقادیر بین ۱ تا ۱۰۰ پذیرفته می‌شوند. پیش‌فرض ۱۰۰ است.
timeoutIntegerاختیاریمدت زمان (بر حسب ثانیه) برای انتظار در حالت Long Polling. اگر آپدیتی در این مدت دریافت نشود، پاسخ خالی بازگردانده می‌شود. استفاده از این پارامتر باعث کاهش تعداد درخواست‌ها و بهبود کارایی می‌شود.
getUpdates — متد (API بله) | ایران ناتیفیکیشن