Reyta Bot API

Reyta’da chat-botlarni oddiy HTTPS API orqali yarating. U Telegram Bot API’ni takrorlaydi, shuning uchun siz biladigan metodlar, parametrlar va JSON javoblar bu yerda oʻzgarishsiz ishlaydi – mavjud bot esa bitta qatorni oʻzgartirish bilan koʻchiriladi.

Kirish

Bot API – bu HTTPS endpointlar toʻplami. Har bir chaqiruv asosiy URL, bot tokeningiz va metod nomidan iborat. Siz parametrlar yuborasiz – JSON qaytadi. Server tomonida hech narsa oʻrnatish shart emas: HTTP-mijozi bor istalgan til u bilan ishlaydi.

Endpoint koʻrinishi
https://api.reyta.uz/bot<token>/METHOD_NAME

Har bir javob bir xil «konvert»ga ega: mantiqiy ok va muvaffaqiyatda result, xatoda esa error_code hamda tushunarli description.

JSONJavob konverti
{ "ok": true,  "result": { ... } }
{ "ok": false, "error_code": 401, "description": "Unauthorized" }

Token BotMother’da bot yaratganda beriladi. Bu – yagona kirish kaliti, uni parol kabi saqlang.

Tez boshlash

Tokeningizni tekshirish va botni koʻrish uchun getMe’ni chaqiring. Buni terminalga qoʻying (<token> oʻrniga oʻzingiznikini qoʻying):

ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/getMe"
JSONJavob
{
  "ok": true,
  "result": {
    "id": 770001,
    "is_bot": true,
    "first_name": "My Bot",
    "username": "my_bot"
  }
}

Butun model shu: getMe’ni quyidagi istalgan metodga almashtiring, uning parametrlarini qoʻshing va javobdagi JSON’ni oʻqing.

Avtorizatsiya

Token toʻgʻridan-toʻgʻri soʻrov manzilida uzatiladi – alohida sarlavha yoki OAuth bosqichi yoʻq. Uni sir saqlang: token kimda boʻlsa, botni oʻsha boshqaradi. Agar token oshkor boʻlsa, uni BotMother’da bekor qilib, qayta chiqaring.

ShellTokenni tekshirish
curl "https://api.reyta.uz/bot<token>/getMe"

Soʻrovlar

Parametrlarni soʻrov qatori, form-kodlangan tana (application/x-www-form-urlencoded) yoki JSON (application/json) koʻrinishida yuboring. Fayl yuklash uchun multipart/form-data’dan foydalaning. Aksar metodlar ham GET, ham POST orqali ishlaydi.

ShellJSON tanali soʻrov
curl "https://api.reyta.uz/bot<token>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 987654321, "text": "Hello from Reyta"}'

Telegram’dan koʻchish

Interfeys Telegram Bot API bilan bir xil boʻlgani uchun koʻchish – qayta yozish emas, balki sozlamani oʻzgartirish. Kutubxonangizdagi API asosiy manzilini Reyta’ga yoʻnaltiring va BotMother’dan token oling. Metod chaqiruvlaringiz, yangilanishlarni qayta ishlash va tiplar oʻzgarishsiz qoladi. Quyida ommabop kutubxonalar uchun bir qatorli oʻzgarishlar (grammY va Telegraf shu endpointda tekshirilgan).

grammY (Node / TypeScript)

TypeScriptgrammy.ts
import { Bot } from "grammy";

const bot = new Bot("<token>", {
  client: { apiRoot: "https://api.reyta.uz" },
});

console.log(await bot.api.getMe());

Telegraf (Node / TypeScript)

TypeScripttelegraf.ts
import { Telegraf } from "telegraf";

const bot = new Telegraf("<token>", {
  telegram: { apiRoot: "https://api.reyta.uz" },
});

console.log(await bot.telegram.getMe());

python-telegram-bot

Pythonbot.py
from telegram.ext import ApplicationBuilder

app = (
    ApplicationBuilder()
    .token("<token>")
    .base_url("https://api.reyta.uz/bot")
    .build()
)

Boshqa istalgan kutubxona yoki toʻgʻridan-toʻgʻri HTTP

Agar kutubxonangizda API asosiy URL, host yoki apiRoot parametri boʻlsa, uni https://api.reyta.uz qilib belgilang. API’ga toʻgʻridan-toʻgʻri murojaat qilsangiz – shunchaki hostni oʻzgartiring:

Asosiy URL
- https://api.telegram.org/bot<token>/sendMessage
+ https://api.reyta.uz/bot<token>/sendMessage

Xabar yuborish

Foydalanuvchi yoki chatga yozish uchun uning chat_id’si kerak. Uni olishning eng oddiy yoʻli: botingizga xabar yuboring va getUpdates orqali oʻqing – chat.id javobda boʻladi. Soʻngra:

ShellsendMessage
curl "https://api.reyta.uz/bot<token>/sendMessage" \
  -d "chat_id=987654321" \
  -d "text=Salom! My bot is live on Reyta." \
  -d "parse_mode=HTML"

Inline-klaviatura qoʻshing, xabarga javob bering yoki media biriktiring – parametrlar quyida har bir metod ostida keltirilgan.

Yangilanishlarni olish

Kiruvchi hodisalarni long polling yoki webhook orqali oling. Bittasini tanlang – ular bir-birini istisno qiladi.

POST/bot<token>/getUpdates→ Array of UpdateQisman qoʻllab-quvvatlanadi

Long polling orqali yangi yangilanishlarni soʻraydi. Update obyektlari massivini qaytaradi.

allowed_updates oʻqish paytida filtrlaydi: filtrlangan yangilanishlar qaytarilmaydi, lekin navbatda qoladi va ulardan keyingi offset tasdiqlanmaguncha pending_update_count da hisoblanadi.

ParametrTurMajburiyTavsif
offsetIntegerIxtiyoriyQaytariladigan birinchi yangilanish identifikatori. Tasdiqlash uchun oxirgi olingan update_id + 1 ni koʻrsating.
limitIntegerIxtiyoriyOlinadigan yangilanishlar soni, 1–100. Standart 100.
timeoutIntegerIxtiyoriyLong polling taymauti soniyada. 0 – qisqa soʻrov (faqat test uchun).
allowed_updatesArray of StringIxtiyoriyOlinadigan yangilanish turlari roʻyxati, masalan ["message","callback_query"].
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/getUpdates" \
  -d "timeout=30&offset=1"
JSONJavob
{
  "ok": true,
  "result": [
    {
      "update_id": 100001,
      "message": {
        "message_id": 42,
        "from": { "id": 987654321, "is_bot": false, "first_name": "Aziz" },
        "chat": { "id": 987654321, "type": "private" },
        "date": 1783900000,
        "text": "/start"
      }
    }
  ]
}
POST/bot<token>/setWebhook→ True

Yangilanishlarni push orqali olish uchun HTTPS-URL roʻyxatdan oʻtkazadi. Reyta har bir yangilanishni JSON POST sifatida yetkazadi.

ParametrTurMajburiyTavsif
urlStringHaYangilanishlar yuboriladigan HTTPS-URL. Boʻsh satr webhook’ni oʻchiradi.
secret_tokenStringIxtiyoriy1–256 belgi; soʻrovlarni tekshirishingiz uchun X-Telegram-Bot-Api-Secret-Token sarlavhasida qaytariladi.
allowed_updatesArray of StringIxtiyoriyOlinadigan yangilanish turlari.
max_connectionsIntegerIxtiyoriyYetkazish uchun bir vaqtdagi maksimal HTTPS-ulanishlar, 1–100. Standart 40.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/setWebhook" \
  -d "url=https://your-bot.example/hook&secret_token=s3cr3t"
JSONJavob
{ "ok": true, "result": true, "description": "Webhook was set" }
POST/bot<token>/deleteWebhook→ True

Webhook’ni oʻchiradi va getUpdates’ga qaytaradi.

ParametrTurMajburiyTavsif
drop_pending_updatesBooleanIxtiyoriyUshbu chaqiruvgacha navbatda toʻplanganini tashlab yuborish.
GET/bot<token>/getWebhookInfo→ WebhookInfo

Joriy webhook holati, kutilayotgan yangilanishlar soni va oxirgi xato.

Xabar yuborish

Matn, media va har qanday kontentni bot yeta oladigan istalgan chatga yetkazing.

POST/bot<token>/sendMessage→ MessageQisman qoʻllab-quvvatlanadi

Matnli xabar yuboradi. Markdown/HTML formatlash va inline-klaviaturalarni qoʻllab-quvvatlaydi.

reply_to_message obyekti javob berilgan xabarning id va chatini oʻz ichiga oladi, mazmunini emas — kerak boʻlsa uni id boʻyicha oling. link_preview_options javobda qaytarilmaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaChatning noyob identifikatori yoki kanalning @username’i.
textStringHaXabar matni, 1–4096 belgi.
parse_modeStringIxtiyoriyFormatlash uchun "MarkdownV2" yoki "HTML".
reply_markupObjectIxtiyoriyInline-klaviatura, reply-klaviatura yoki force-reply.
disable_notificationBooleanIxtiyoriyBildirishnoma tovushisiz, jimgina yuborish.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/sendMessage" \
  -d "chat_id=987654321" \
  -d "text=Salom! Reyta Bot API is live." \
  -d "parse_mode=HTML"
JSONJavob
{
  "ok": true,
  "result": {
    "message_id": 43,
    "chat": { "id": 987654321, "type": "private" },
    "date": 1783900050,
    "text": "Salom! Reyta Bot API is live."
  }
}
POST/bot<token>/sendPhoto→ Message

Rasmni file_id, HTTP-URL yoki multipart yuklash orqali yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat.
photoString or InputFileHafile_id, HTTPS-URL yoki yuklangan fayl.
captionStringIxtiyoriySarlavha, 0–1024 belgi.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/sendPhoto" \
  -F chat_id=1000100 -F caption="Look" -F photo=@cat.jpg
JSONJavob
{
  "ok": true,
  "result": {
    "message_id": 512,
    "from": { "id": 523722417021, "is_bot": true, "first_name": "Jokebot" },
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900000,
    "caption": "Look",
    "photo": [ { "file_id": "l8BvW8G5ZiGyZcYCX...", "file_unique_id": "k9UIku2zcCg", "width": 320, "height": 240, "file_size": 8123 } ]
  }
}
POST/bot<token>/forwardMessage→ Message

Har qanday turdagi xabarni bir chatdan boshqasiga yoʻnaltiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
from_chat_idInteger or StringHaXabar koʻchiriladigan chat.
message_idIntegerHaXabar identifikatori.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/forwardMessage" \
  -d "chat_id=1000100&from_chat_id=-1001234567890&message_id=42"
JSONJavob
{
  "ok": true,
  "result": {
    "message_id": 516,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900030,
    "text": "the forwarded text"
  }
}
POST/bot<token>/copyMessage→ MessageIdQisman qoʻllab-quvvatlanadi

Xabarni yoʻnaltirish sarlavhasisiz nusxalaydi.

Nusxalash va keyin sarlavhani tahrirlash sifatida amalga oshirilgan. Tahrir muvaffaqiyatsiz boʻlsa, nusxa baribir yetkaziladi, lekin yangi sarlavhasiz.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
from_chat_idInteger or StringHaXabar nusxalanadigan chat.
message_idIntegerHaXabar identifikatori.
captionStringIxtiyoriyYangi sarlavha. Koʻrsatilmasa, asl sarlavha saqlanadi.
parse_modeStringIxtiyoriyYangi sarlavha formati: HTML, Markdown yoki MarkdownV2.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/copyMessage" \
  -d "chat_id=1000100&from_chat_id=-1001234567890&message_id=42&caption=New caption"
JSONJavob
{ "ok": true, "result": { "message_id": 517 } }
POST/bot<token>/sendDocument→ Message

Belgilangan hajm chegarasidagi istalgan faylni yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
documentInputFile or StringHaFayl: file_id, HTTPS-URL yoki multipart yuklash.
captionStringIxtiyoriySarlavha, 0-1024 belgi.
parse_modeStringIxtiyoriyMarkdown, MarkdownV2 yoki HTML.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
thumbnailInputFileIxtiyoriyMuqova rasmi, multipart qism sifatida yuklanadi. Eski thumb nomi ham qabul qilinadi.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/sendDocument" \
  -F chat_id=1000100 -F [email protected]
JSONJavob
{
  "ok": true,
  "result": {
    "message_id": 513,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900010,
    "document": { "file_id": "qWQSGcLKbVNV1I3y...", "file_unique_id": "Ch0MHHySQBAA", "file_name": "report.pdf", "mime_type": "application/pdf", "file_size": 20481 }
  }
}
POST/bot<token>/sendVideo→ Message

MP4 videoni yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
videoInputFile or StringHaVideo: file_id, HTTPS-URL yoki multipart yuklash.
captionStringIxtiyoriySarlavha, 0-1024 belgi.
parse_modeStringIxtiyoriyMarkdown, MarkdownV2 yoki HTML.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
durationIntegerIxtiyoriyDavomiylik, soniyalarda.
widthIntegerIxtiyoriyKenglik, piksellarda.
heightIntegerIxtiyoriyBalandlik, piksellarda.
supports_streamingBooleanIxtiyoriyVideoni striming uchun mos deb belgilash.
has_spoilerBooleanIxtiyoriyMediani spoyler ostida yashirish.
thumbnailInputFileIxtiyoriyMuqova rasmi, multipart qism sifatida yuklanadi. Eski thumb nomi ham qabul qilinadi.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendAnimation→ Message

Ovozsiz GIF yoki H.264/MPEG-4 animatsiyani yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
animationInputFile or StringHaAnimatsiya: file_id, HTTPS-URL yoki multipart yuklash.
captionStringIxtiyoriySarlavha, 0-1024 belgi.
parse_modeStringIxtiyoriyMarkdown, MarkdownV2 yoki HTML.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
durationIntegerIxtiyoriyDavomiylik, soniyalarda.
widthIntegerIxtiyoriyKenglik, piksellarda.
heightIntegerIxtiyoriyBalandlik, piksellarda.
has_spoilerBooleanIxtiyoriyMediani spoyler ostida yashirish.
thumbnailInputFileIxtiyoriyMuqova rasmi, multipart qism sifatida yuklanadi. Eski thumb nomi ham qabul qilinadi.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendAudio→ Message

Musiqa pleyerida koʻrsatiladigan audio faylni yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
audioInputFile or StringHaAudio: file_id, HTTPS-URL yoki multipart yuklash.
captionStringIxtiyoriySarlavha, 0-1024 belgi.
parse_modeStringIxtiyoriyMarkdown, MarkdownV2 yoki HTML.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
durationIntegerIxtiyoriyDavomiylik, soniyalarda.
performerStringIxtiyoriyAudio ijrochisi.
titleStringIxtiyoriyNomi.
thumbnailInputFileIxtiyoriyMuqova rasmi, multipart qism sifatida yuklanadi. Eski thumb nomi ham qabul qilinadi.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendVoice→ Message

Ovozli xabar yuboradi (OGG/OPUS).

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
voiceInputFile or StringHaOvozli xabar: file_id, HTTPS-URL yoki multipart yuklash.
captionStringIxtiyoriySarlavha, 0-1024 belgi.
parse_modeStringIxtiyoriyMarkdown, MarkdownV2 yoki HTML.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
durationIntegerIxtiyoriyDavomiylik, soniyalarda.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendVideoNote→ Message

Yumaloq, kvadrat video-xabar yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
video_noteInputFile or StringHaVideo xabar: file_id yoki multipart yuklash.
lengthIntegerIxtiyoriyKvadrat video xabar tomonining uzunligi.
durationIntegerIxtiyoriyDavomiylik, soniyalarda.
thumbnailInputFileIxtiyoriyMuqova rasmi, multipart qism sifatida yuklanadi. Eski thumb nomi ham qabul qilinadi.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendMediaGroup→ Array of Message

Bir guruh rasm/video/hujjatni albom sifatida yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
mediaArray of InputMediaHaAlbom elementlarini tavsiflovchi JSON massiv.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/sendMediaGroup" \
  -d chat_id=1000100 \
  -d 'media=[{"type":"photo","media":"https://reyta.uz/a.jpg","caption":"one"},{"type":"photo","media":"https://reyta.uz/b.jpg"}]'
JSONJavob
{
  "ok": true,
  "result": [
    { "message_id": 514, "chat": { "id": 1000100, "type": "private" }, "media_group_id": "2093252871779782656", "caption": "one", "photo": [] },
    { "message_id": 515, "chat": { "id": 1000100, "type": "private" }, "media_group_id": "2093252871779782656", "photo": [] }
  ]
}
POST/bot<token>/sendLocation→ Message

Xaritadagi nuqtani yuboradi; jonli lokatsiya ham boʻlishi mumkin.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
latitudeFloatHaNuqtaning kengligi.
longitudeFloatHaNuqtaning uzunligi.
live_periodIntegerIxtiyoriyLokatsiya jonli qolish soniyalari, 60-86400. Boʻlmasa – bir martalik lokatsiya.
POST/bot<token>/sendVenue→ Message

Manzil (joy) haqidagi maʼlumotni yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
latitudeFloatHaNuqtaning kengligi.
longitudeFloatHaNuqtaning uzunligi.
titleStringHaNomi.
addressStringHaJoyning manzili.
foursquare_idStringIxtiyoriyJoyning Foursquare identifikatori.
foursquare_typeStringIxtiyoriyJoyning Foursquare toifasi.
google_place_idStringIxtiyoriyJoyning Google Places identifikatori.
google_place_typeStringIxtiyoriyJoyning Google Places toifasi.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendContact→ Message

Telefon kontaktini yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
phone_numberStringHaKontakt telefon raqami.
first_nameStringHaKontakt ismi.
last_nameStringIxtiyoriyKontakt familiyasi.
vcardStringIxtiyoriyvCard formatidagi qoʻshimcha kontakt maʼlumotlari.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendPoll→ MessageHozircha mavjud emas

Soʻrovnoma yoki viktorina yuboradi.

Hozircha amalga oshirilmagan – 501 qaytaradi. Soʻrovnomalar server tomonida qoʻllab-quvvatlanmaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
questionStringHaSoʻrovnoma savoli.
optionsArray of StringHaJavob variantlari JSON massivi.
is_anonymousBooleanIxtiyoriyKim ovoz berganini yashirish.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendDice→ Message

Tasodifiy qiymatli animatsion emoji yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
emojiStringIxtiyoriyZar animatsiyasi asoslangan emoji.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.
POST/bot<token>/sendChatAction→ True

«yozmoqda…» yoki «yuklamoqda…» holatini koʻrsatadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
actionStringHaKoʻrsatiladigan harakat: typing, upload_photo, record_video va hokazo.
POST/bot<token>/sendSticker→ Message

Statik, animatsion yoki video stikerni yuboradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
stickerStringHaServerda allaqachon mavjud stikerning file_id qiymati – uni getStickerSet yoki kiruvchi yangilanishdan oling.
reply_to_message_idIntegerIxtiyoriyStikerni ushbu xabarga javob sifatida yuborish.
reply_markupInlineKeyboardMarkupIxtiyoriyStikerga biriktirilgan inline-klaviatura.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/sendSticker" \
  -d "chat_id=1000100&sticker=CAQAAAABHGv42k_AEABAvG9SmO6EnQAAAAEAAAAAAAAAAA"
JSONJavob
{
  "ok": true,
  "result": {
    "message_id": 1022,
    "from": { "id": 523722417021, "is_bot": true, "first_name": "Jokebot", "username": "Jokeformebot" },
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787863074,
    "sticker": {
      "file_id": "CAQAAAABHGv42k_AEABAvG9SmO6EnQAAAAEAAAAAAAAAAA",
      "file_unique_id": "Chxr-NpPwBAA",
      "type": "regular",
      "width": 512,
      "height": 512,
      "is_video": true,
      "emoji": "\uD83D\uDC4D",
      "file_size": 126387
    }
  }
}
POST/bot<token>/copyMessages→ Array of MessageId

Bir nechta xabarni asl nusxaga havolasiz koʻchiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
from_chat_idInteger or StringHaXabar olinayotgan chat.
message_idsArray of IntegerHaXabar id lari JSON massivi.
remove_captionBooleanIxtiyoriyAsl sarlavhasiz nusxalash.
POST/bot<token>/forwardMessages→ Array of MessageId

Bir nechta xabarni asl muallifni saqlagan holda birdaniga uzatadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
from_chat_idInteger or StringHaXabar olinayotgan chat.
message_idsArray of IntegerHaXabar id lari JSON massivi.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
protect_contentBooleanIxtiyoriyYuborilgan xabarni uzatish va saqlashni taqiqlash.
reply_to_message_idIntegerIxtiyoriyUshbu xabarga javob sifatida yuborish.
message_thread_idIntegerIxtiyoriyXabar tegishli forum mavzusi.

Tahrirlash va oʻchirish

Bot yuborgan xabarlarni tahrirlash yoki oʻchirish. chat_id + message_id boʻyicha tahrirlash hamma joyda ishlaydi; inline_message_id boʻyicha inline xabarni tahrirlash hozircha qoʻllab-quvvatlanmaydi.

POST/bot<token>/editMessageText→ Message or TrueQisman qoʻllab-quvvatlanadi

Yuborilgan yoki inline xabar matnini tahrirlaydi.

inline_message_id boʻyicha tahrirlash hozircha qoʻllab-quvvatlanmaydi – 501 qaytaradi. chat_id + message_id boʻyicha tahrirlash ishlaydi.

ParametrTurMajburiyTavsif
textStringHaXabarning yangi matni.
chat_idInteger or StringIxtiyoriyMaqsadli chat. inline_message_id ishlatilmasa majburiy.
message_idIntegerIxtiyoriyTahrirlanadigan xabar. inline_message_id ishlatilmasa majburiy.
parse_modeStringIxtiyoriyFormat: HTML, Markdown yoki MarkdownV2.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/editMessageText" \
  -d "chat_id=1000100&message_id=512&text=Updated&parse_mode=HTML"
JSONJavob
{
  "ok": true,
  "result": {
    "message_id": 512,
    "chat": { "id": 1000100, "type": "private" },
    "date": 1787900000,
    "text": "Updated"
  }
}
POST/bot<token>/editMessageCaption→ Message or TrueQisman qoʻllab-quvvatlanadi

Media xabar sarlavhasini tahrirlaydi.

inline_message_id boʻyicha tahrirlash hozircha qoʻllab-quvvatlanmaydi – 501 qaytaradi. chat_id + message_id boʻyicha tahrirlash ishlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.
inline_message_idStringIxtiyoriyInline xabar identifikatori.
captionStringIxtiyoriySarlavha, 0-1024 belgi.
parse_modeStringIxtiyoriyMarkdown, MarkdownV2 yoki HTML.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
POST/bot<token>/editMessageMedia→ Message or TrueQisman qoʻllab-quvvatlanadi

Xabardagi mediani almashtiradi.

chat_id + message_id boʻyicha ishlaydi (media file_id, URL yoki attach:// yuklash orqali; InputMedia sarlavhasi xabar sarlavhasini almashtiradi). inline_message_id boʻyicha tahrirlash hozircha qoʻllab-quvvatlanmaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.
mediaArray of InputMediaHaAlbom elementlarini tavsiflovchi JSON massiv.
inline_message_idStringIxtiyoriyInline xabar identifikatori.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
POST/bot<token>/editMessageReplyMarkup→ Message or TrueQisman qoʻllab-quvvatlanadi

Xabarning faqat inline-klaviaturasini tahrirlaydi.

inline_message_id boʻyicha tahrirlash hozircha qoʻllab-quvvatlanmaydi – 501 qaytaradi. chat_id + message_id boʻyicha tahrirlash ishlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.
inline_message_idStringIxtiyoriyInline xabar identifikatori.
reply_markupInlineKeyboardMarkupIxtiyoriyXabarga biriktirilgan JSON klaviatura.
POST/bot<token>/editMessageLiveLocation→ Message or TrueQisman qoʻllab-quvvatlanadi

Faol jonli lokatsiyani koʻchiradi.

inline_message_id boʻyicha tahrirlash hozircha qoʻllab-quvvatlanmaydi – 501 qaytaradi. chat_id + message_id boʻyicha tahrirlash ishlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.
inline_message_idStringIxtiyoriyInline xabar identifikatori.
latitudeFloatIxtiyoriyNuqtaning kengligi.
longitudeFloatIxtiyoriyNuqtaning uzunligi.
live_periodIntegerIxtiyoriyNuqta necha soniya jonli qoladi.
headingIntegerIxtiyoriyFoydalanuvchi harakat yoʻnalishi, 1-360 daraja.
proximity_alert_radiusIntegerIxtiyoriyYaqinlashuv ogohlantirishlari uchun masofa, metrda.
POST/bot<token>/deleteMessage→ True

Bot yuborgan xabarni yoki bot admin boʻlgan istalgan xabarni oʻchiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
message_idIntegerHaXabar identifikatori.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/deleteMessage" -d "chat_id=1000100&message_id=512"
JSONJavob
{ "ok": true, "result": true }
POST/bot<token>/deleteMessages→ True

Bir nechta xabarni bir vaqtda oʻchiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idsArray of IntegerHaXabar id lari JSON massivi.
POST/bot<token>/stopMessageLiveLocation→ Message or TrueQisman qoʻllab-quvvatlanadi

Faol jonli lokatsiya yangilanishini muddati tugashidan oldin toʻxtatadi.

inline_message_id boʻyicha toʻxtatish hozircha qoʻllab-quvvatlanmaydi – 501 qaytaradi. chat_id + message_id boʻyicha ishlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.
inline_message_idStringIxtiyoriyInline xabar identifikatori.
POST/bot<token>/setMessageReaction→ True

Xabarga botning reaksiyasini qoʻyadi yoki olib tashlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.
is_bigBooleanIxtiyoriyKatta reaksiya animatsiyasini oʻynatish.
reactionArray of ReactionTypeIxtiyoriyReaksiyalar JSON massivi; boʻsh massiv ularni olib tashlaydi.
POST/bot<token>/stopPoll→ PollQisman qoʻllab-quvvatlanadi

Bot yuborgan faol soʻrovnomani toʻxtatadi.

Yakuniy Poll obyekti oʻrniga true qaytaradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.

Inline va callback’lar

Inline soʻrovlarga va inline tugmalar bosilishiga javob berish. Har bir javob soʻrov id siga bogʻlangan va u bilan birga tugaydi — darhol javob bering.

POST/bot<token>/answerCallbackQuery→ True

Inline-tugma bosilishiga javob beradi; ixtiyoriy ravishda ogohlantirish koʻrsatadi.

ParametrTurMajburiyTavsif
callback_query_idStringHaJavob beriladigan callback soʻrovi identifikatori.
textStringIxtiyoriyBildirishnoma matni, 200 belgigacha.
show_alertBooleanIxtiyoriyToast oʻrniga modal oyna koʻrsatish.
urlStringIxtiyoriyMijoz ochadigan URL.
cache_timeIntegerIxtiyoriyNatija mijoz tomonida necha soniya keshlanishi mumkin.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/answerCallbackQuery" \
  -d "callback_query_id=4382bfdwdsb323b2d9&text=Saved"
JSONJavob
{ "ok": true, "result": true }
POST/bot<token>/answerInlineQuery→ TrueQisman qoʻllab-quvvatlanadi

Inline-soʻrovga natijalar roʻyxati bilan javob beradi.

Qoʻllab-quvvatlanadigan natija turlari: article, photo, gif, mpeg4_gif, video, audio, voice, document, sticker, location, venue va contact - Bot API belgilaganidek, ham URL, ham cached (*_file_id) koʻrinishida. Oʻyinlar qoʻllab-quvvatlanmaydi va 400 qaytaradi.

ParametrTurMajburiyTavsif
inline_query_idStringHaInline soʻrov identifikatori.
resultsArray of InlineQueryResultHaNatijalar JSON massivi. Qoʻllab-quvvatlanadi: article, photo, gif, mpeg4_gif, document.
cache_timeIntegerIxtiyoriyNatijani keshlash soniyalari, 1-300 (standart 300).
is_personalBooleanIxtiyoriyNatijalarni har bir foydalanuvchi uchun alohida keshlash.
next_offsetStringIxtiyoriyKeyingi sahifa uchun ofset, 64 baytgacha.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/answerInlineQuery" \
  -d inline_query_id=1234567890 \
  -d 'results=[{"type":"article","id":"1","title":"Hello","input_message_content":{"message_text":"Hello!"}}]'
JSONJavob
{ "ok": true, "result": true }

Chatlar va aʼzolar

Chatlar, aʼzolar, taklif havolalari va admin huquqlarini koʻring va boshqaring.

GET/bot<token>/getChat→ ChatQisman qoʻllab-quvvatlanadi

Chat haqida dolzarb maʼlumot.

Toʻliq ChatFullInfo qaytaradi. pinned_message obyektida qadalgan xabarning id si va chati bor, matni emas — kerak boʻlsa uni id boʻyicha oling.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/getChat" -d chat_id=-1001234567890
JSONJavob
{
  "ok": true,
  "result": {
    "id": -1001234567890,
    "type": "supergroup",
    "title": "Reyta devs",
    "username": "reytadevs",
    "description": "Server talk",
    "invite_link": "https://t.me/+abcdef",
    "member_count": 128,
    "permissions": { "can_send_messages": true, "can_send_photos": true, "can_pin_messages": false }
  }
}
GET/bot<token>/getChatAdministrators→ Array of ChatMember

Chat administratorlari roʻyxati.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
GET/bot<token>/getChatMember→ ChatMember

Chatning bitta aʼzosi haqida maʼlumot.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
user_idIntegerHaMaqsadli foydalanuvchi identifikatori.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/getChatMember" -d "chat_id=-1001234567890&user_id=1000100"
JSONJavob
{
  "ok": true,
  "result": {
    "status": "administrator",
    "user": { "id": 1000100, "is_bot": false, "first_name": "Johan" },
    "custom_title": "Founder"
  }
}
GET/bot<token>/getChatMemberCount→ Integer

Chatdagi aʼzolar soni.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
GET/bot<token>/getUserProfilePhotos→ UserProfilePhotos

Foydalanuvchining profil rasmlari.

ParametrTurMajburiyTavsif
user_idIntegerHaMaqsadli foydalanuvchi.
offsetIntegerIxtiyoriyShu id gacha yangilanishlarni tasdiqlaydi va oʻshandan boshlaydi.
limitIntegerIxtiyoriyNechta yangilanish qaytarilsin, 1-100.
POST/bot<token>/setChatTitle→ True

Guruh, superguruh yoki kanal nomini oʻzgartiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
titleStringHaNomi.
POST/bot<token>/setChatDescription→ True

Guruh, superguruh yoki kanal tavsifini oʻzgartiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
descriptionStringIxtiyoriyTavsif matni.
POST/bot<token>/setChatPhoto→ True

Chat uchun yangi rasm oʻrnatadi. Bot administrator boʻlishi kerak.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
photoInputFileHaRasm fayli, multipart qism sifatida yuklanadi.
POST/bot<token>/deleteChatPhoto→ True

Chat rasmini oʻchiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
POST/bot<token>/pinChatMessage→ True

Chatdagi xabarni mahkamlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerHaMaqsadli xabar.
disable_notificationBooleanIxtiyoriyBildirishnoma ovozisiz yetkazish.
POST/bot<token>/unpinChatMessage→ True

Mahkamlangan xabarni yechadi. message_id boʻlmasa oxirgi mahkamlash olib tashlanadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_idIntegerIxtiyoriyMaqsadli xabar.
POST/bot<token>/unpinAllChatMessages→ True

Chatdagi barcha mahkamlangan xabarlarni yechadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
POST/bot<token>/leaveChat→ True

Bot guruh, superguruh yoki kanaldan chiqadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.

Moderatsiya

Bloklash, cheklash va admin tayinlash. Botga chatda tegishli administrator huquqi kerak.

POST/bot<token>/banChatMember→ True

Foydalanuvchini guruh, superguruh yoki kanaldan bloklaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
user_idIntegerHaMaqsadli foydalanuvchi identifikatori.
revoke_messagesBooleanIxtiyoriyUshbu foydalanuvchining chatdagi barcha xabarlarini oʻchirish.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/banChatMember" \
  -d "chat_id=-1001234567890&user_id=1000100&revoke_messages=true"
JSONJavob
{ "ok": true, "result": true }
POST/bot<token>/banChatSenderChat→ True

Superguruhga oʻz nomidan yozayotgan kanalni bloklaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli superguruh: raqamli id yoki @username.
sender_chat_idIntegerHaChatga yozayotgan kanal yoki superguruh id si.
POST/bot<token>/unbanChatSenderChat→ True

Superguruhda kanal blokini olib tashlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli superguruh: raqamli id yoki @username.
sender_chat_idIntegerHaChatga yozayotgan kanal yoki superguruh id si.
POST/bot<token>/setChatStickerSet→ True

Superguruhning stikerlar toʻplamini oʻrnatadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli superguruh: raqamli id yoki @username.
sticker_set_nameStringHaToʻplamning qisqa nomi, getStickerSet dagi kabi.
POST/bot<token>/deleteChatStickerSet→ True

Superguruhdan stikerlar toʻplamini olib tashlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli superguruh: raqamli id yoki @username.
POST/bot<token>/unpinAllGeneralForumTopicMessages→ True

Forumning General mavzusidagi barcha xabarlarni yechadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli superguruh: raqamli id yoki @username.
POST/bot<token>/unbanChatMember→ True

Blokni olib tashlaydi, foydalanuvchi taklif havolasi orqali qaytishi mumkin.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
user_idIntegerHaMaqsadli foydalanuvchi.
only_if_bannedBooleanIxtiyoriyFoydalanuvchi bloklanmagan boʻlsa, hech nima qilmaslik.
POST/bot<token>/restrictChatMember→ True

Superguruh aʼzosining huquqlarini cheklaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
user_idIntegerHaMaqsadli foydalanuvchi identifikatori.
permissionsChatPermissionsHaAʼzoga nima ruxsat etilganini bildiruvchi JSON obyekt.
POST/bot<token>/promoteChatMember→ True

Aʼzoni administrator huquqlarini belgilab koʻtaradi yoki tushiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
user_idIntegerHaMaqsadli foydalanuvchi identifikatori.
can_manage_chatBooleanIxtiyoriyTegishli administrator huquqini beradi. Har bir huquq – alohida mantiqiy parametr.
POST/bot<token>/setChatAdministratorCustomTitle→ True

Bot tayinlagan administrator uchun maxsus unvon belgilaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
user_idIntegerHaMaqsadli foydalanuvchi.
custom_titleStringHaAdministrator yonida koʻrsatiladigan unvon, 0-16 belgi.
POST/bot<token>/setChatPermissions→ True

Superguruhning barcha aʼzolari uchun standart huquqlarni belgilaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
permissionsChatPermissionsHacan_* bayroqlari bilan JSON obyekt.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/setChatPermissions" \
  -d chat_id=-1001234567890 \
  -d 'permissions={"can_send_messages":true,"can_send_photos":false}'
JSONJavob
{ "ok": true, "result": true }

Botni sozlash

Botning oʻz profili: nomi, tavsiflari, buyruqlar roʻyxati va standart administrator huquqlari. Ularning har biri til boʻyicha - lokalizatsiya uchun language_code yuboring yoki standart qiymat uchun tashlab keting.

GET/bot<token>/getMe→ User

Bot haqida asosiy maʼlumot. Tokenni tez tekshirish usuli.

POST/bot<token>/setMyCommands→ True

Botning buyruqlar roʻyxatini belgilaydi.

ParametrTurMajburiyTavsif
commandsArray of BotCommandHaBuyruqlar JSON massivi, 0-100 ta.
scopeBotCommandScopeIxtiyoriyBuyruqlar qayerda amal qiladi. Hozircha faqat default qamrovi hisobga olinadi.
language_codeStringIxtiyoriyBuyruqlar tegishli boʻlgan ikki harfli til kodi.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/setMyCommands" \
  -d 'commands=[{"command":"start","description":"Begin"},{"command":"help","description":"How it works"}]' \
  -d 'scope={"type":"all_private_chats"}'
JSONJavob
{ "ok": true, "result": true }
GET/bot<token>/getMyCommands→ Array of BotCommand

Botning joriy buyruqlar roʻyxati.

ParametrTurMajburiyTavsif
scopeBotCommandScopeIxtiyoriyJSON scope: default, all_private_chats, all_group_chats, all_chat_administrators, chat, chat_administrators yoki chat_member.
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
POST/bot<token>/setMyName→ True

Bot nomini belgilaydi.

ParametrTurMajburiyTavsif
nameStringIxtiyoriyNomi.
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
GET/bot<token>/getMyName→ BotName

Botning joriy nomi.

ParametrTurMajburiyTavsif
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
POST/bot<token>/setMyDescription→ True

Bot tavsifini belgilaydi.

ParametrTurMajburiyTavsif
descriptionStringIxtiyoriyTavsif matni.
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
POST/bot<token>/setChatMenuButton→ TrueQisman qoʻllab-quvvatlanadi

Botning chatdagi menyu tugmasini oʻzgartiradi.

web_app tugma turi 400 bilan rad etiladi. Faqat shaxsiy chatlar uchun.

ParametrTurMajburiyTavsif
menu_buttonMenuButtonIxtiyoriyJSON menyu tugmasi: default yoki commands.
chat_idInteger or StringIxtiyoriyMaqsadli chat: raqamli id yoki @username.
POST/bot<token>/logOut→ True

Botni oʻz serveringizga koʻchirishdan oldin bulutli Bot API’dan chiqadi.

POST/bot<token>/deleteMyCommands→ True

Berilgan qamrov va til uchun bot buyruqlari roʻyxatini oʻchiradi.

ParametrTurMajburiyTavsif
scopeBotCommandScopeIxtiyoriyJSON scope: default, all_private_chats, all_group_chats, all_chat_administrators, chat, chat_administrators yoki chat_member.
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
GET/bot<token>/getMyDescription→ BotDescription

Boʻsh chat ekranida koʻrsatiladigan bot tavsifini qaytaradi.

ParametrTurMajburiyTavsif
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
POST/bot<token>/setMyShortDescription→ True

Bot profilida koʻrsatiladigan qisqa tavsifni belgilaydi.

ParametrTurMajburiyTavsif
short_descriptionStringIxtiyoriyBot profilida koʻrsatiladigan qisqa tavsif.
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
GET/bot<token>/getMyShortDescription→ BotShortDescription

Botning qisqa tavsifini qaytaradi.

ParametrTurMajburiyTavsif
language_codeStringIxtiyoriyIkki harfli til kodi; boʻsh boʻlsa - standart qiymat.
GET/bot<token>/getChatMenuButton→ MenuButtonQisman qoʻllab-quvvatlanadi

Chat uchun bot menyu tugmasini yoki standart qiymatni qaytaradi.

Faqat default yoki commands qaytaradi. Boshqa turdagi tugma default sifatida oʻqiladi.

ParametrTurMajburiyTavsif
chat_idInteger or StringIxtiyoriyMaqsadli chat: raqamli id yoki @username.
POST/bot<token>/setMyDefaultAdministratorRights→ True

Bot chatga qoʻshilganda soʻraladigan administrator huquqlarini belgilaydi.

ParametrTurMajburiyTavsif
rightsChatAdministratorRightsIxtiyoriyStandart administrator huquqlari bilan JSON obyekt.
for_channelsBooleanIxtiyoriyHuquqlarni guruhlarga emas, kanallarga qoʻllash.
GET/bot<token>/getMyDefaultAdministratorRights→ ChatAdministratorRights

Botning standart administrator huquqlarini qaytaradi.

ParametrTurMajburiyTavsif
for_channelsBooleanIxtiyoriyHuquqlarni guruhlarga emas, kanallarga qoʻllash.
POST/bot<token>/setUserEmojiStatus→ True

Botga ruxsat etilgan maxsus emoji yordamida foydalanuvchining emoji holatini belgilaydi.

ParametrTurMajburiyTavsif
user_idIntegerHaMaqsadli foydalanuvchi.
emoji_status_custom_emoji_idStringIxtiyoriyFoydalanuvchi statusi sifatidagi maxsus emoji.
emoji_status_expiration_dateIntegerIxtiyoriyEmoji status tugaydigan Unix vaqti.
POST/bot<token>/close→ TrueQisman qoʻllab-quvvatlanadi

Botni serverlar orasida koʻchirishdan oldin nusxasini yopadi.

Qabul qilinadi va true qaytaradi, lekin hech nima qilmaydi – Reyta’da lokal server modeli yoʻq.

Fayllar va stikerlar

Botga koʻrinadigan fayllarni yuklab olish va stiker toʻplamlarini yaratish. API orqali yaratilgan toʻplam uni yaratgan botga tegishli.

GET/bot<token>/getFile→ File

Faylni yuklab olishga tayyorlaydi va uning yoʻli bilan File qaytaradi.

ParametrTurMajburiyTavsif
file_idStringHaFayl identifikatori. Javobda /file/bot<token>/<file_path> orqali yuklab olish uchun file_path keladi.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/getFile" -d file_id=CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA
JSONJavob
{
  "ok": true,
  "result": {
    "file_id": "CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA",
    "file_unique_id": "Ch0MHHySQBAA",
    "file_size": 888,
    "file_path": "sticker/CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA"
  }
}
GET/bot<token>/getStickerSet→ StickerSet

Nomi boʻyicha stikerlar toʻplami.

ParametrTurMajburiyTavsif
nameStringHaNomi.
GET/bot<token>/getCustomEmojiStickers→ Array of Sticker

id boʻyicha maxsus emoji-stikerlar haqida maʼlumot.

ParametrTurMajburiyTavsif
custom_emoji_idsArray of StringHaMaxsus emoji id lari JSON massivi.
POST/bot<token>/createNewStickerSet→ TrueQisman qoʻllab-quvvatlanadi

Foydalanuvchiga tegishli yangi stikerlar toʻplamini yaratadi.

Toʻplam egasi uni yaratgan bot boʻladi, user_id emas — Reyta egalikni API chaqiruvchisidan oladi. needs_repainting qabul qilinadi, lekin saqlanmaydi.

ParametrTurMajburiyTavsif
user_idIntegerHaSoʻrovchini bildiradi. Toʻplam egasi — chaqiruvchi bot.
nameStringHaToʻplamning qisqa nomi, 5-64 belgi: avval harf, keyin harflar, raqamlar va pastki chiziq.
titleStringHaToʻplam nomi, 1-64 belgi.
stickersArray of InputStickerHaJSON massiv, koʻpi bilan 50 element. Har birida sticker (uploadStickerFile dan olingan file_id yoki shu soʻrovning qismini koʻrsatuvchi attach://&lt;maydon&gt;), format va emoji_list kerak; keywords va mask_position ixtiyoriy.
sticker_typeStringIxtiyoriyregular (standart), mask yoki custom_emoji.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/createNewStickerSet" \
  -F user_id=1000100 -F name=mypack_by_yourbot -F title="My pack" \
  -F 'stickers=[{"sticker":"attach://s1","format":"static","emoji_list":["🔥"]}]' \
  -F s1=@cat.webp
JSONJavob
{ "ok": true, "result": true }
POST/bot<token>/deleteStickerFromSet→ True

Stikerni toʻplamdan oʻchiradi.

ParametrTurMajburiyTavsif
stickerStringHaStikerning file_id qiymati.
POST/bot<token>/deleteStickerSet→ True

Bot yaratgan stikerlar toʻplamini oʻchiradi.

ParametrTurMajburiyTavsif
nameStringHaNomi.
POST/bot<token>/setStickerSetTitle→ True

Bot yaratgan stikerlar toʻplamini qayta nomlaydi.

ParametrTurMajburiyTavsif
nameStringHaNomi.
titleStringHaNomi.
POST/bot<token>/setStickerPositionInSet→ True

Stikerni toʻplamdagi boshqa oʻringa koʻchiradi.

ParametrTurMajburiyTavsif
stickerStringHaStikerning file_id qiymati.
positionIntegerHaToʻplamdagi joy, noldan boshlab.
POST/bot<token>/setStickerEmojiList→ True

Stiker bilan bogʻlangan emojilarni almashtiradi.

ParametrTurMajburiyTavsif
stickerStringHaStikerning file_id qiymati.
emoji_listArray of StringHa1-20 ta emoji JSON massivi.
POST/bot<token>/setStickerKeywords→ True

Stikerning qidiruv kalit soʻzlarini almashtiradi.

ParametrTurMajburiyTavsif
stickerStringHaStikerning file_id qiymati.
keywordsArray of StringIxtiyoriyQidiruv kalit soʻzlari JSON massivi.
POST/bot<token>/setStickerMaskPosition→ True

Niqob-stikerning yuzdagi joylashuvini oʻzgartiradi.

ParametrTurMajburiyTavsif
stickerStringHaStikerning file_id qiymati.
mask_positionMaskPositionIxtiyoriyJSON obyekt: point (forehead, eyes, mouth, chin), x_shift, y_shift, scale.
POST/bot<token>/uploadStickerFile→ FileQisman qoʻllab-quvvatlanadi

Keyinchalik toʻplamda ishlatish uchun stiker faylini yuklaydi.

Fayl saqlashdan oldin tekshiriladi: format, oʻlchamlar (bir tomoni 512px), TGS kadrlar chastotasi va davomiyligi, WebM kodeki. Rad etilgan fayl buzilgan qoida nomi bilan 400 qaytaradi.

ParametrTurMajburiyTavsif
user_idIntegerHaYuklash kim uchun bajarilayotgani. Reytada har qanday toʻplam egasi — chaqiruvchi bot, shuning uchun bu maydon faqat soʻrovchini bildiradi.
stickerInputFileHaStiker fayli, multipart/form-data sifatida yuklanadi.
sticker_formatStringHastatic (.webp), animated (.tgs) yoki video (.webm) dan biri.
ShellSoʻrov
curl "https://api.reyta.uz/bot<token>/uploadStickerFile" \
  -F user_id=1000100 -F sticker_format=static -F sticker=@cat.webp
JSONJavob
{
  "ok": true,
  "result": {
    "file_id": "CAQAAAABHQwcfJJAEAAQgUZMXHglLAAAAAEAAAAAAAAAAA",
    "file_unique_id": "Ch0MHHySQBAA",
    "file_size": 888
  }
}
POST/bot<token>/addStickerToSet→ TrueQisman qoʻllab-quvvatlanadi

Bot yaratgan toʻplamga yangi stiker qoʻshadi.

Toʻplamda allaqachon bor stiker takrorlanmaydi — 400 qaytadi. Faqat toʻplam egasi boʻlgan bot qoʻsha oladi.

ParametrTurMajburiyTavsif
user_idIntegerHaSoʻrovchini bildiradi.
nameStringHaToʻplamning qisqa nomi.
stickerInputStickerHasticker (file_id yoki attach://&lt;maydon&gt;), format va emoji_list maydonli JSON obyekt.
POST/bot<token>/replaceStickerInSet→ TrueQisman qoʻllab-quvvatlanadi

Toʻplamdagi mavjud stikerni almashtiradi.

Almashtiruvchi eski stiker oʻchirilishidan oldin qoʻshiladi, shuning uchun rad etilgan almashtirish toʻplamni oʻzgartirmaydi.

ParametrTurMajburiyTavsif
user_idIntegerHaSoʻrovchini bildiradi.
nameStringHaToʻplamning qisqa nomi.
old_stickerStringHaAlmashtirilayotgan stikerning file_id qiymati.
stickerInputStickerHaAlmashtiruvchi, addStickerToSet dagi kabi shaklda.
POST/bot<token>/setStickerSetThumbnail→ TrueQisman qoʻllab-quvvatlanadi

Stikerlar toʻplamining muqovasini belgilaydi.

Muqova sifatida faqat shu toʻplamdagi stiker ishlatiladi; alohida rasm yuklash 400 qaytaradi.

ParametrTurMajburiyTavsif
nameStringHaToʻplamning qisqa nomi.
user_idIntegerHaSoʻrovchini bildiradi.
thumbnailStringIxtiyoriyToʻplamda allaqachon mavjud stikerning file_id qiymati. Muqovani tozalash uchun yubormang — mijozlar birinchi stikerni oladi.
POST/bot<token>/setCustomEmojiStickerSetThumbnail→ True

Maxsus emoji toʻplamining muqovasini belgilaydi.

ParametrTurMajburiyTavsif
nameStringHaMaxsus emoji toʻplamining qisqa nomi.
custom_emoji_idStringIxtiyoriyToʻplamdagi maxsus emoji identifikatori. Hujjatning oʻnlik id si ham, getStickerSet chiqargan file_unique_id ham qabul qilinadi. Tozalash uchun yubormang.

Forum mavzulari

Forum superguruhidagi mavzularni boshqarish. Bu yerdagi har bir metod forum rejimi yoqilgan superguruhni talab qiladi — kanal yoki oddiy guruh rad etiladi.

POST/bot<token>/createForumTopic→ ForumTopic

Forum-superguruhda mavzu yaratadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat identifikatori yoki @channelusername.
nameStringHaMavzu nomi, 128 belgigacha.
icon_colorIntegerIxtiyoriyBelgi rangi RGB son koʻrinishida.
icon_custom_emoji_idStringIxtiyoriyMavzu belgisi sifatida maxsus emoji.
POST/bot<token>/editForumTopic→ True

Forum mavzusining nomi/belgisini tahrirlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_thread_idIntegerHaXabar tegishli forum mavzusi.
nameStringIxtiyoriyNomi.
icon_custom_emoji_idStringIxtiyoriyMavzu ikonkasi sifatidagi maxsus emoji.
POST/bot<token>/deleteForumTopic→ True

Forum mavzusini xabarlari bilan birga oʻchiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_thread_idIntegerHaXabar tegishli forum mavzusi.
POST/bot<token>/closeForumTopic→ True

Forum mavzusini yopadi – yangi xabar yuborib boʻlmaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_thread_idIntegerHaXabar tegishli forum mavzusi.
POST/bot<token>/reopenForumTopic→ True

Yopilgan forum mavzusini qayta ochadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_thread_idIntegerHaXabar tegishli forum mavzusi.
POST/bot<token>/unpinAllForumTopicMessages→ True

Forum mavzusidagi barcha mahkamlangan xabarlarni yechadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
message_thread_idIntegerHaXabar tegishli forum mavzusi.
POST/bot<token>/editGeneralForumTopic→ True

Forumning General mavzusini qayta nomlaydi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
nameStringHaNomi.
POST/bot<token>/closeGeneralForumTopic→ True

Forumning General mavzusini yopadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
POST/bot<token>/reopenGeneralForumTopic→ True

Forumning General mavzusini qayta ochadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
POST/bot<token>/hideGeneralForumTopic→ True

General mavzusini forum mavzulari roʻyxatidan yashiradi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
POST/bot<token>/unhideGeneralForumTopic→ True

General mavzusini qayta koʻrsatadi.

ParametrTurMajburiyTavsif
chat_idInteger or StringHaMaqsadli chat: raqamli id yoki @username.
GET/bot<token>/getForumTopicIconStickers→ Array of StickerQisman qoʻllab-quvvatlanadi

Forum mavzusi belgisi sifatida mavjud stikerlarni qaytaradi.

Reytada mavzu ikonkalari uchun tayyor toʻplam yoʻq. Operator serverga maxsus emoji toʻplamini koʻrsatishi mumkin; ungacha metod boʻsh massiv qaytaradi va mijozlar ikonka tanlashni koʻrsatmaydi.