ارسال درخواست

همهٔ درخواست‌ها به Bot API باید از طریق HTTPS و با این الگو ارسال شوند:

https://api.telegram.org/bot<token>/METHOD_NAME

به‌عنوان مثال:

https://api.telegram.org/bot123456789:AAExampleTokenExampleTokenExample/getMe

متدها هم با GET و هم با POST پشتیبانی می‌شوند و نام متدها به بزرگی و کوچکی حروف حساس است. چهار روش برای ارسال پارامترها وجود دارد:

• رشتهٔ query در URL
• application/x-www-form-urlencoded
• application/json (به‌جز آپلود فایل)
• multipart/form-data (برای آپلود فایل)

پاسخ همیشه یک شیء JSON است که فیلد ok (بولین) دارد. اگر ok برابر true باشد، درخواست موفق بوده و نتیجه در فیلد result است. اگر false باشد، فیلد description توضیح خطا را می‌دهد و error_code یک عدد صحیح است که ممکن است در آینده تغییر کند. بعضی خطاها فیلد اختیاری parameters از نوع ResponseParameters دارند که برای مدیریت خودکار خطا (مثلاً صبر کردن بعد از خطای ۴۲۹) مفید است.

همهٔ پرس‌وجوها باید با کدگذاری UTF-8 انجام شوند.