ایران ناتیفیکیشن
ورودشروع رایگان
مستنداتv1 stable
SDKهادریافت کلید API

دریافت درخواست‌ها (Polling)

پیام‌های رسیده به ربات را بخوانید (getUpdates)، بدون نیاز به سرور وب‌هوک.

POSThttps://api.irnoti.com/v1/broker/bots/{id}/updates
scope: broker.request

فقط وقتی وب‌هوک تنظیم نیست کار می‌کند (قانون تلگرام). برای تأیید دریافت، offset را برابر update_id آخر + ۱ بگذارید. timeout تا ۲۵ ثانیه برای long polling.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسه ربات در بروکر.
offsetبدنهnumberشناسهٔ اولین آپدیت موردنظر.
limitبدنهnumber۱ تا ۱۰۰ (پیش‌فرض ۱۰۰).
timeoutبدنهnumberثانیه، حداکثر ۲۵.
allowedUpdatesبدنهstring[]نوع آپدیت‌های موردنظر.

خطاهای خاص این endpoint

200اگر وب‌هوک فعال باشد، تلگرام در response خطای 409 می‌دهد؛ اول وب‌هوک را حذف کنید.

اجرای زنده (محیط تست)

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

→ قبلی
ارسال درخواست به تلگرام
بعدی ←
وضعیت وب‌هوک
curl -X POST 'https://api.irnoti.com/v1/broker/bots/31/updates' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "limit": 10,
  "timeout": 10
}'
پاسخ نمونه200 OK
{
  "status": 200,
  "response": {
    "ok": true,
    "result": [
      {
        "message": {
          "chat": {
            "id": 123456789
          },
          "text": "سلام",
          "message_id": 5
        },
        "update_id": 801
      }
    ]
  }
}