Turlar

Bot API javoblaridagi obyektlar. Maydonlar ro'yxati server kodidagi serializatordan olingan: bu yerda yo'q maydon botga kelmaydi. Ixtiyoriy maydonlar qiymati bo'lmasa javobda umuman bo'lmaydi (null emas).

User

Bot ko'radigan yagona foydalanuvchi shakli. Maydonlar qat'iy ro'yxat (whitelist) bo'yicha: quyidagilardan boshqa hech narsa botga bormaydi. Telefon, rasm, bio, tug'ilgan kun, onlayn holat, kontaktlar, joylashuv va haqiqiy hisob id'si hech qachon berilmaydi.

Maydon	Turi	Majburiy	Izoh
`id`	Integer	Majburiy	Shu botga xos psevdonim raqam (10–13 xonali). Har bir bot bir odam uchun boshqa raqam ko'radi. Shaxsiy chatda `chat.id` bilan bir xil.
`is_bot`	Boolean	Majburiy	Foydalanuvchi uchun doim `false`.
`first_name`	String	Majburiy	Ism, ≤64 belgi. Ism bo'sh bo'lsa — `"User"`.
`last_name`	String	Ixtiyoriy	Familiya, ≤64 belgi. Bo'lmasa maydon yo'q.
`username`	String	Ixtiyoriy	Ochiq username. Bo'lmasa maydon yo'q.
`language_code`	String	Ixtiyoriy	Ilova tili (2–3 kichik harf, masalan `uz`, `en`, `ru`). Noma'lum bo'lsa maydon yo'q.

Misol

{
  "id": 4810235517,
  "is_bot": false,
  "first_name": "Ali",
  "last_name": "Valiyev",
  "username": "ali",
  "language_code": "uz"
}

User (bot)

Botning o'zi: getMe javobi, bot yuborgan xabarlardagi from, ChatMember.user va guruhdagi boshqa botlar (new_chat_members, left_chat_member). Barcha maydonlar har doim keladi.

Maydon	Turi	Majburiy	Izoh
`id`	Integer	Majburiy	Botning raqamli id'si (tokendagi `:` belgisidan oldingi qism).
`is_bot`	Boolean	Majburiy	Doim `true`.
`first_name`	String	Majburiy	Botning nomi.
`username`	String	Majburiy	Botning username'i.
`can_join_groups`	Boolean	Majburiy	Botni guruh va kanallarga qo'shish mumkinmi (@ZaminBot /setjoingroups, standart `true`).
`can_read_all_group_messages`	Boolean	Majburiy	Egasining sozlamasi: privacy mode o'chirilgan (@ZaminBot /setprivacy, standart `false`). O'zi hech qachon "barcha xabarlar"ni yoqmaydi: buning uchun bot guruh admini bo'lishi va guruh egasi huquqni aniq berishi kerak (batafsil). Guruhdagi haqiqiy holat — ChatMember'da.
`supports_inline_queries`	Boolean	Majburiy	Doim `false` (inline rejim yo'q).

Misol

{
  "id": 1000001,
  "is_bot": true,
  "first_name": "Ob-havo",
  "username": "ObHavoBot",
  "can_join_groups": true,
  "can_read_all_group_messages": false,
  "supports_inline_queries": false
}

Chat

Chat turi type maydonida:

private — shaxsiy chat; id foydalanuvchining psevdonim id'si bilan bir xil (musbat).
group — guruh; id -<10 raqam>, masalan -4012345678.
channel — kanal; id -100<10 raqam>.
supergroup — kanalning izohlari chati (linked_chat_id); id -100….

Guruh va kanal id'lari tasodifiy, lekin doimiy: ularni bazangizda saqlash mumkin. description, permissions va linked_chat_id faqat getChat javobida keladi.

Maydon	Turi	Majburiy	Izoh
`id`	Integer	Majburiy	Chat id'si. Shaxsiy chatda `= from.id`; guruh va kanalda manfiy.
`type`	String	Majburiy	`private`, `group`, `channel` yoki `supergroup`.
`title`	String	Ixtiyoriy	Guruh, kanal yoki izohlar chati nomi.
`username`	String	Ixtiyoriy	Shaxsiy chat: foydalanuvchi username'i. Guruh yoki kanal: faqat ochiq bo'lsa (shu bilan `chat_id: "@username"` ishlaydi).
`first_name`	String	Ixtiyoriy	Shaxsiy chat: foydalanuvchining ismi (doim bor).
`last_name`	String	Ixtiyoriy	Shaxsiy chat: familiya.
`description`	String	Ixtiyoriy	getChat: guruh yoki kanal tavsifi (bo'lsa).
`permissions`	ChatPermissions	Ixtiyoriy	getChat, guruh: oddiy a'zolar nima qila oladi.
`linked_chat_id`	Integer	Ixtiyoriy	getChat, kanal: izohlar yoqilgan bo'lsa — izohlar chati id'si.

Misol

{"id": -4012345678, "type": "group", "title": "Dasturchilar"}

ChatPermissions

Guruhda oddiy a'zolarga nima ruxsat etilgani (guruh sozlamalari). getChat javobida keladi. restrictChatMember'da hozircha faqat can_send_messages ishlaydi.

Maydon	Turi	Majburiy	Izoh
`can_send_messages`	Boolean	Ixtiyoriy	Matn yozish.
`can_send_media_messages`	Boolean	Ixtiyoriy	Fayl yuborish.
`can_pin_messages`	Boolean	Ixtiyoriy	Xabar qadash.
`can_change_info`	Boolean	Ixtiyoriy	Nom, tavsif, rasmni o'zgartirish.
`can_invite_users`	Boolean	Ixtiyoriy	A'zo qo'shish.

Misol

{
  "can_send_messages": true,
  "can_send_media_messages": true,
  "can_pin_messages": false,
  "can_change_info": false,
  "can_invite_users": true
}

Message

Chatdagi xabar. Ixtiyoriy maydonlar faqat qiymati bo'lsa keladi. message_id — chat ichida o'sib boruvchi butun son (bot va foydalanuvchi xabarlari uchun umumiy). Guruhda bu guruhning umumiy xabar raqami (hamma uchun bir xil, oraliqlar bo'lishi mumkin); kanal va izohlarda — bot birinchi marta ko'rganda beriladigan raqam.

Guruhdagi xabarlar faqat privacy mode ruxsat bergan hollarda keladi. Boshqa botlarning xabarlari hech qachon kelmaydi.

Maydon	Turi	Majburiy	Izoh
`message_id`	Integer	Majburiy	Xabar raqami (shu chat ichida).
`from`	User	Ixtiyoriy	Yuboruvchi: foydalanuvchi yoki bot (User (bot)). Kanal postlarida yo'q (o'rniga `sender_chat`); xizmat xabarlarida bo'lmasligi mumkin.
`sender_chat`	Chat	Ixtiyoriy	Kanal posti: kanalning o'zi.
`chat`	Chat	Majburiy	Chat.
`date`	Integer	Majburiy	Yuborilgan vaqt (Unix soniya).
`edit_date`	Integer	Ixtiyoriy	Oxirgi tahrir vaqti.
`text`	String	Ixtiyoriy	Matn (1–4096).
`caption`	String	Ixtiyoriy	Fayl ostidagi matn (≤1024). Bo'sh bo'lsa maydon yo'q.
`photo`	Array of PhotoSize	Ixtiyoriy	Rasm. Hozircha doim bitta element.
`document`	Document	Ixtiyoriy	Hujjat (istalgan fayl).
`video`	Video	Ixtiyoriy	Video.
`audio`	Audio	Ixtiyoriy	Audio.
`voice`	Voice	Ixtiyoriy	Guruh: ovozli xabar.
`video_note`	VideoNote	Ixtiyoriy	Guruh: dumaloq video xabar.
`contact`	Contact	Ixtiyoriy	Foydalanuvchi `request_contact` tugmasi orqali tasdiqlab yuborgan o'z telefon raqami (faqat shaxsiy chat).
`location`	Location	Ixtiyoriy	Shaxsiy chat: `request_location` tugmasi orqali tasdiqlab yuborilgan joylashuv. Guruh: a'zo yuborgan joylashuv (bot uni ko'rishga haqli bo'lsa).
`reply_to_message`	Message	Ixtiyoriy	Javob qilingan xabar (bir daraja, o'zida yana reply_to_message bo'lmaydi). O'chirilgan bo'lsa yo'q. Guruhda faqat botning o'z xabari to'liq keladi; boshqalarning xabari mazmunsiz: `{message_id, chat, date, from}` — botning nusxasida iqtibos matni yo'q (bot nusxasi).
`reply_markup`	InlineKeyboardMarkup	Ixtiyoriy	Xabarga biriktirilgan inline klaviatura (faqat bot xabarlarida).
`new_chat_members`	Array of User	Ixtiyoriy	Xizmat xabari: guruhga qo'shilganlar (odamlar yoki botlar, botning o'zi ham).
`left_chat_member`	User	Ixtiyoriy	Xizmat xabari: guruhdan chiqqan yoki chiqarilgan odam (yoki bot).
`new_chat_title`	String	Ixtiyoriy	Xizmat xabari: guruhning yangi nomi.
`message_thread_id`	Integer	Ixtiyoriy	Kanal izohi: qaysi postga yozilgani (post raqami).

Misol

{
  "message_id": 15,
  "from": {
    "id": 4810235517,
    "is_bot": false,
    "first_name": "Ali",
    "last_name": "Valiyev",
    "username": "ali",
    "language_code": "uz"
  },
  "chat": {
    "id": 4810235517,
    "type": "private",
    "first_name": "Ali",
    "last_name": "Valiyev",
    "username": "ali"
  },
  "date": 1791106200,
  "text": "Ertaga-chi?",
  "reply_to_message": {
    "message_id": 14,
    "from": {
      "id": 1000001,
      "is_bot": true,
      "first_name": "Ob-havo",
      "username": "ObHavoBot",
      "can_join_groups": true,
      "can_read_all_group_messages": false,
      "supports_inline_queries": false
    },
    "chat": {
      "id": 4810235517,
      "type": "private",
      "first_name": "Ali",
      "last_name": "Valiyev",
      "username": "ali"
    },
    "date": 1791106080,
    "text": "Bugun +24°C ☀️"
  }
}

PhotoSize

Rasm. Server rasmlarni JPEG'ga qayta kodlaydi (eng katta tomoni ≤2048 px, EXIF olib tashlanadi).

Maydon	Turi	Majburiy	Izoh
`file_id`	String	Majburiy	Faylni qayta yuborish yoki getFile uchun. Shu botga xos.
`file_unique_id`	String	Majburiy	Barqaror noyob id (fayl ↔ bot juftligi uchun). Qayta yuborish uchun ishlatib bo'lmaydi.
`width`	Integer	Majburiy	Kenglik, px.
`height`	Integer	Majburiy	Balandlik, px.
`file_size`	Integer	Majburiy	Hajmi, bayt.

Document

Hujjat. mime_type fayl mazmunidan aniqlanadi; rasm, video va audio bo'lmagan barcha fayllar uchun application/octet-stream.

Maydon	Turi	Majburiy	Izoh
`file_id`	String	Majburiy
`file_unique_id`	String	Majburiy
`file_size`	Integer	Majburiy	Bayt.
`mime_type`	String	Majburiy
`file_name`	String	Ixtiyoriy	Asl nom (≤120 belgi). Rasmlarda bo'lmaydi.
`width`	Integer	Ixtiyoriy	Faqat rasm hujjat sifatida yuborilganda.
`height`	Integer	Ixtiyoriy	Faqat rasm hujjat sifatida yuborilganda.

Video

Video (MP4, MOV, WebM). Shaxsiy chatda kenglik, balandlik va davomiylik berilmaydi; guruhda kenglik va balandlik (noma'lum bo'lsa 0) keladi. Eskiz (thumbnail) yo'q.

Maydon	Turi	Majburiy	Izoh
`file_id`	String	Majburiy
`file_unique_id`	String	Majburiy
`file_size`	Integer	Majburiy
`mime_type`	String	Majburiy	Masalan `video/mp4`.
`file_name`	String	Ixtiyoriy	Shaxsiy chat.
`width`	Integer	Ixtiyoriy	Guruh: kenglik, px.
`height`	Integer	Ixtiyoriy	Guruh: balandlik, px.
`duration`	Integer	Ixtiyoriy	Guruh: davomiylik, soniya (a'zo yuborgan videoda, ilova bergan bo'lsa).

Audio

Audio fayl. Maydonlari Document bilan bir xil (ijrochi, nom kabi maydonlar yo'q).

Maydon	Turi	Majburiy	Izoh
`file_id`	String	Majburiy
`file_unique_id`	String	Majburiy
`file_size`	Integer	Majburiy
`mime_type`	String	Majburiy	Masalan `audio/mpeg`, `audio/mp4`.
`file_name`	String	Ixtiyoriy	Shaxsiy chat.
`duration`	Integer	Ixtiyoriy	Guruh: a'zo yuborgan audioda, ilova bergan bo'lsa.

Voice

Ovozli xabar (faqat guruhda, a'zo yuborganda). Yuklab olish — getFile.

Maydon	Turi	Majburiy	Izoh
`file_id`	String	Majburiy
`file_unique_id`	String	Majburiy
`file_size`	Integer	Majburiy
`mime_type`	String	Majburiy	Masalan `audio/mp4`.
`duration`	Integer	Ixtiyoriy	Davomiylik, soniya (yuboruvchi ilova bergan bo'lsa).

VideoNote

Dumaloq video xabar (faqat guruhda, a'zo yuborganda).

Maydon	Turi	Majburiy	Izoh
`file_id`	String	Majburiy
`file_unique_id`	String	Majburiy
`file_size`	Integer	Majburiy
`length`	Integer	Majburiy	Video tomoni, px (bo'lmasa 0).
`duration`	Integer	Ixtiyoriy	Davomiylik, soniya.

Contact

Foydalanuvchining o'z telefon raqami. Faqat bot request_contact tugmali reply klaviatura yuborganda va foydalanuvchi uni bosib, tasdiqlaganda keladi.

Maydon	Turi	Majburiy	Izoh
`phone_number`	String	Majburiy	Telefon raqam, masalan `+998901234567`.
`first_name`	String	Majburiy
`last_name`	String	Ixtiyoriy
`user_id`	Integer	Majburiy	Yuboruvchining psevdonim id'si (= `from.id`).

Misol

{
  "phone_number": "+998901234567",
  "first_name": "Ali",
  "last_name": "Valiyev",
  "user_id": 4810235517
}

Location

Faqat request_location tugmasi bosilib, foydalanuvchi tasdiqlaganda keladi. Bu bir martalik nuqta (jonli joylashuv emas).

Maydon	Turi	Majburiy	Izoh
`latitude`	Float	Majburiy	-90 … 90
`longitude`	Float	Majburiy	-180 … 180

Misol

{"latitude": 41.311081, "longitude": 69.240562}

InlineKeyboardMarkup

Xabarga biriktiriladigan tugmalar. Cheklovlar: ≤12 qator, qatorda ≤8 tugma, jami ≤100; bo'sh qator bo'lmasin.

Maydon	Turi	Majburiy	Izoh
`inline_keyboard`	Array of Array of InlineKeyboardButton	Majburiy	Qatorlar.

Misol

{
  "inline_keyboard": [
    [
      {"text": "✅ Ha", "callback_data": "yes"},
      {"text": "Sayt", "url": "https://example.com"}
    ]
  ]
}

InlineKeyboardButton

Inline tugma. callback_data, url va web_appdan aynan bittasi bo'lishi shart. Boshqa maydonlar (masalan, switch_inline_query) xato beradi.

Maydon	Turi	Majburiy	Izoh
`text`	String	Majburiy	1–64 belgi (bosh/oxiridagi bo'shliqsiz).
`callback_data`	String	Ixtiyoriy	1–64 bayt (UTF-8). Bosilganda bot CallbackQuery oladi.
`url`	String	Ixtiyoriy	≤2048 belgi. Faqat http/https; zamin.app faqat `https://zamin.app/<username>?start=…` (qoidalar).
`web_app`	WebAppInfo	Ixtiyoriy	`{"url": "https://…"}`. Hozircha oddiy havola sifatida ochiladi (JS ko'prigi yo'q).

WebAppInfo

Kelajak uchun zahiralangan: hozircha ilova bu havolani ichki brauzerda ochadi.

Maydon	Turi	Majburiy	Izoh
`url`	String	Majburiy	Faqat https, URL qoidalariga mos.

ReplyKeyboardMarkup

Tizim klaviaturasi o'rnida ko'rsatiladigan tugmalar. U chatning faol klaviaturasiga aylanadi: almashtirilguncha yoki olib tashlanguncha turadi. Oddiy tugma bosilsa, uning matni oddiy xabar bo'lib keladi. Cheklovlar inline klaviatura bilan bir xil (kamida bitta qator).

Maydon	Turi	Majburiy	Izoh
`keyboard`	Array of Array of KeyboardButton	Majburiy	Tugma o'rniga oddiy matn (String) ham yozish mumkin.
`resize_keyboard`	Boolean	Ixtiyoriy	Joylashuv uchun ishora.
`one_time_keyboard`	Boolean	Ixtiyoriy	true — foydalanuvchining keyingi xabaridan keyin klaviatura yo'qoladi.
`is_persistent`	Boolean	Ixtiyoriy	Saqlanadi, ilovaga uzatiladi.
`input_field_placeholder`	String	Ixtiyoriy	≤64 belgi.
`selective`	Boolean	Ixtiyoriy	Qabul qilinadi, e'tiborga olinmaydi.

Misol

{
  "keyboard": [
    [{"text": "📱 Raqamni yuborish", "request_contact": true}],
    [{"text": "📍 Joylashuv", "request_location": true}, "Yordam"]
  ],
  "resize_keyboard": true,
  "one_time_keyboard": true
}

KeyboardButton

Reply klaviatura tugmasi. request_contact va request_location bir vaqtda bo'lmaydi. Ikkala holatda ham ilova foydalanuvchidan tasdiq so'raydi.

Maydon	Turi	Majburiy	Izoh
`text`	String	Majburiy	1–64 belgi.
`request_contact`	Boolean	Ixtiyoriy	Foydalanuvchining o'z telefon raqamini so'raydi.
`request_location`	Boolean	Ixtiyoriy	Joriy joylashuvni so'raydi.

ReplyKeyboardRemove

Faol reply klaviaturani olib tashlaydi.

Maydon	Turi	Majburiy	Izoh
`remove_keyboard`	Boolean	Majburiy	Doim `true`.
`selective`	Boolean	Ixtiyoriy	Qabul qilinadi, e'tiborga olinmaydi.

Misol

{"remove_keyboard": true}

CallbackQuery

Inline tugma bosildi. Unga answerCallbackQuery bilan 60 soniya ichida javob bering. Server faqat haqiqatan shu xabar klaviaturasida bor callback_data'ni qabul qiladi.

Guruhda ham shunday: from — tugmani bosgan a'zo, message — botning guruhdagi xabari, javob faqat bosgan odamga ko'rinadi.

Maydon	Turi	Majburiy	Izoh
`id`	String	Majburiy	Javob uchun id.
`from`	User	Majburiy	Tugmani bosgan foydalanuvchi.
`message`	Message	Majburiy	Tugmasi bosilgan bot xabari.
`chat_instance`	String	Majburiy	Chat uchun barqaror identifikator (raqamli matn).
`data`	String	Majburiy	Tugmaning `callback_data`'si.

Misol

{
  "id": "q7Lm2xYp9RtVb4Nw",
  "from": {
    "id": 4810235517,
    "is_bot": false,
    "first_name": "Ali",
    "last_name": "Valiyev",
    "username": "ali",
    "language_code": "uz"
  },
  "message": {
    "message_id": 14,
    "from": {
      "id": 1000001,
      "is_bot": true,
      "first_name": "Ob-havo",
      "username": "ObHavoBot",
      "can_join_groups": true,
      "can_read_all_group_messages": false,
      "supports_inline_queries": false
    },
    "chat": {
      "id": 4810235517,
      "type": "private",
      "first_name": "Ali",
      "last_name": "Valiyev",
      "username": "ali"
    },
    "date": 1791106200,
    "text": "Tasdiqlaysizmi?",
    "reply_markup": {
      "inline_keyboard": [[{"text": "✅ Ha", "callback_data": "yes"}]]
    }
  },
  "chat_instance": "8150337712093445123",
  "data": "yes"
}

ChatMemberUpdated

Kimningdir chatdagi holati o'zgardi.

my_chat_member — botning o'zi: shaxsiy chatda foydalanuvchi botni boshladi, blokladi yoki qayta boshladi; guruh yoki kanalda botni qo'shishdi, admin qilishdi, huquqlarini o'zgartirishdi, adminlikdan olishdi yoki chiqarishdi.
chat_member — guruhdagi odam qo'shildi, chiqdi, chiqarildi yoki ban qilindi (faqat admin-botlarga va so'ralgan bo'lsa).

Maydon	Turi	Majburiy	Izoh
`chat`	Chat	Majburiy
`from`	User	Majburiy	Amalni bajargan odam (yoki bot o'zi chiqqanda — botning o'zi).
`date`	Integer	Majburiy	Unix soniya.
`old_chat_member`	ChatMember	Majburiy	Avvalgi holat.
`new_chat_member`	ChatMember	Majburiy	Yangi holat.

Misol

{
  "chat": {"id": -4012345678, "type": "group", "title": "Dasturchilar"},
  "from": {
    "id": 4810235517,
    "is_bot": false,
    "first_name": "Ali",
    "last_name": "Valiyev",
    "username": "ali",
    "language_code": "uz"
  },
  "date": 1791106200,
  "old_chat_member": {
    "user": {
      "id": 1000001,
      "is_bot": true,
      "first_name": "Ob-havo",
      "username": "ObHavoBot",
      "can_join_groups": true,
      "can_read_all_group_messages": false,
      "supports_inline_queries": false
    },
    "status": "member"
  },
  "new_chat_member": {
    "user": {
      "id": 1000001,
      "is_bot": true,
      "first_name": "Ob-havo",
      "username": "ObHavoBot",
      "can_join_groups": true,
      "can_read_all_group_messages": false,
      "supports_inline_queries": false
    },
    "status": "administrator",
    "can_change_info": false,
    "can_delete_messages": true,
    "can_restrict_members": true,
    "can_invite_users": false,
    "can_pin_messages": true,
    "can_post_messages": false,
    "can_edit_messages": false,
    "can_promote_members": false,
    "can_manage_video_chats": false,
    "can_read_all_group_messages": false
  }
}

ChatMember

Kimningdir chatdagi holati. Shaxsiy chatda bu botning holati: birinchi Start — left → member; bloklash yoki "To'xtatish" — member → kicked; blokdan chiqarib qayta Start — kicked → member.

Guruh va kanalda (getChatMember, getChatAdministrators, my_chat_member, chat_member) qo'shimcha holatlar va admin huquqlari keladi. Huquq maydonlari faqat administrator holatida bo'ladi. Kanal adminlarida (bot va odam) can_read_all_group_messages va can_manage_video_chats bo'lmaydi.

Maydon	Turi	Majburiy	Izoh
`user`	User	Majburiy	Odam yoki bot (User (bot)).
`status`	String	Majburiy	`creator` (ega), `administrator`, `member`, `restricted` (jim qilingan), `left` yoki `kicked` (shaxsiy chatda — bloklangan, guruhda — ban).
`can_change_info`	Boolean	Ixtiyoriy	Admin: nom va tavsifni o'zgartirish (setChatTitle, setChatDescription).
`can_delete_messages`	Boolean	Ixtiyoriy	Admin: boshqalarning xabarlarini o'chirish.
`can_restrict_members`	Boolean	Ixtiyoriy	Admin: ban, unban, jim qilish (ilovada "Foydalanuvchilarni cheklash").
`can_invite_users`	Boolean	Ixtiyoriy	Admin: a'zo qo'shish (Bot API'da bunga metod yo'q).
`can_pin_messages`	Boolean	Ixtiyoriy	Admin: xabar qadash.
`can_post_messages`	Boolean	Ixtiyoriy	Admin (kanal): post joylash.
`can_edit_messages`	Boolean	Ixtiyoriy	Admin (kanal): boshqalarning postlarini tahrirlash.
`can_promote_members`	Boolean	Ixtiyoriy	Admin: boshqalarni admin qilish ("Admin tayinlash"). Odam-adminlarda — haqiqiy qiymati; botlarda doim `false` (botlarga berilmaydi).
`can_manage_video_chats`	Boolean	Ixtiyoriy	Admin (guruh): qo'ng'iroqlarni boshqarish. Odam-adminlarda — haqiqiy qiymati; botlarda doim `false`.
`can_read_all_group_messages`	Boolean	Ixtiyoriy	Zamin'ga xos, guruhdagi admin-bot: haqiqiy holat — bot hozir guruhdagi barcha xabarlarni oladimi (bot admin va guruh egasi "Barcha xabarlarni o'qish" huquqini bergan). `my_chat_member`, getChatMember va getChatAdministrators'da bir xil.
`custom_title`	String	Ixtiyoriy	Admin unvoni (faqat getChatAdministrators'da, berilgan bo'lsa).
`is_member`	Boolean	Ixtiyoriy	`restricted`: doim `true`.
`can_send_messages`	Boolean	Ixtiyoriy	`restricted`: doim `false`.
`until_date`	Integer	Ixtiyoriy	`restricted`: cheklov tugash vaqti (Unix soniya); 0 — muddatsiz.

Misol

{
  "user": {
    "id": 5203318874,
    "is_bot": false,
    "first_name": "Vali",
    "username": "vali",
    "language_code": "uz"
  },
  "status": "restricted",
  "is_member": true,
  "can_send_messages": false,
  "until_date": 0
}

Update

Bitta yangilanish. Har birida update_id va quyidagilardan aynan bittasi bo'ladi.

Maydon	Turi	Majburiy	Izoh
`update_id`	Integer	Majburiy	Bot uchun o'sib boruvchi raqam. getUpdates'da `offset` uchun.
`message`	Message	Ixtiyoriy	Yangi xabar: shaxsiy chatda — har bir xabar; guruhda — privacy mode ruxsat berganlari va xizmat xabarlari (`new_chat_members`, `left_chat_member`, `new_chat_title`); kanal izohlari chatida — yangi izohlar.
`edited_message`	Message	Ixtiyoriy	Foydalanuvchi xabarini tahrirladi (48 soat ichida). Guruhda — tahrirlangan matn ham privacy mode shartiga mos bo'lsa.
`callback_query`	CallbackQuery	Ixtiyoriy	Inline tugma bosildi (shaxsiy chat yoki guruh).
`my_chat_member`	ChatMemberUpdated	Ixtiyoriy	Botning holati o'zgardi: boshlandi / bloklandi, guruh yoki kanalga qo'shildi, admin qilindi, chiqarildi.
`chat_member`	ChatMemberUpdated	Ixtiyoriy	Guruhda odam qo'shildi, chiqdi, chiqarildi yoki ban qilindi. Faqat admin-botlarga va faqat `allowed_updates`'da `"chat_member"` aniq ko'rsatilgan bo'lsa.
`channel_post`	Message	Ixtiyoriy	Bot admin bo'lgan kanalda yangi post (botning o'z postlari kelmaydi).
`edited_channel_post`	Message	Ixtiyoriy	Kanal posti tahrirlandi.

Misol

{
  "update_id": 17,
  "message": {
    "message_id": 13,
    "from": {
      "id": 4810235517,
      "is_bot": false,
      "first_name": "Ali",
      "last_name": "Valiyev",
      "username": "ali",
      "language_code": "uz"
    },
    "chat": {
      "id": 4810235517,
      "type": "private",
      "first_name": "Ali",
      "last_name": "Valiyev",
      "username": "ali"
    },
    "date": 1791106200,
    "text": "/start promo_2026"
  }
}

BotCommand

Buyruqlar ro'yxatidagi bitta buyruq.

Maydon	Turi	Majburiy	Izoh
`command`	String	Majburiy	1–32 belgi: `a-z 0-9 _` (kichik harf, `/`siz).
`description`	String	Majburiy	1–256 belgi.

Misol

{"command": "start", "description": "Boshlash"}

WebhookInfo

getWebhookInfo javobi.

Maydon	Turi	Majburiy	Izoh
`url`	String	Majburiy	Webhook manzili; o'rnatilmagan bo'lsa bo'sh qator.
`has_custom_certificate`	Boolean	Majburiy	Doim `false`.
`pending_update_count`	Integer	Majburiy	Navbatdagi yangilanishlar soni.
`max_connections`	Integer	Majburiy	Saqlangan qiymat (standart 40).
`last_error_date`	Integer	Ixtiyoriy	Oxirgi yetkazish xatosi vaqti.
`last_error_message`	String	Ixtiyoriy	Masalan `Wrong response from the webhook: 502`, `Connection timed out`, `Connection failed`.
`allowed_updates`	Array of String	Ixtiyoriy	Faqat filtr o'rnatilgan bo'lsa.

File

getFile javobi. Yuklab olish: https://api.zamin.app/file/bot<TOKEN>/<file_path>.

Maydon	Turi	Majburiy	Izoh
`file_id`	String	Majburiy
`file_unique_id`	String	Majburiy
`file_size`	Integer	Majburiy	Bayt.
`file_path`	String	Majburiy	`files/<file_id>` ko'rinishida.