ZaminDocs

Bot haqida

getMe

Botning o'zi haqidagi ma'lumot. Tokenni tekshirishning eng oddiy usuli.

GEThttps://api.zamin.app/bot<TOKEN>/getMe

POST ham ishlaydi. Parametrlar: query, JSON, form yoki multipart — batafsil.

Parametrsiz metod. Token to'g'ri bo'lsa, botning User obyektini qaytaradi (is_bot: true). Botni ishga tushirganda birinchi bo'lib shu metodni chaqiring: token xato bo'lsa, darhol 401 olasiz.

Ikki maydon bot egasining @ZaminBot'dagi sozlamalarini ko'rsatadi:

  • can_join_groups — botni guruh va kanallarga qo'shish mumkinmi (/setjoingroups, standart: true).
  • can_read_all_group_messages — privacy mode o'chirilganmi (/setprivacy, standart: false). Bu faqat egasining sozlamasi: true bo'lsa ham, bot guruhdagi barcha xabarlarni faqat o'sha guruhning admini bo'lsa va guruh egasi unga "Barcha xabarlarni o'qish" huquqini aniq bergan bo'lsa o'qiydi. Guruhdagi haqiqiy holat — getChatMember'dagi can_read_all_group_messages. Barcha xabarlar.

supports_inline_queries doim false (inline rejim yo'q).

Parametrlar

Parametrlar yo'q.

Javob

Natija (result): User

JSON
{
  "ok": true,
  "result": {
    "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
  }
}

Xatolar

Bu metodga xos xato yo'q.

Istalgan metodda bo'lishi mumkin: 401 Unauthorized, 403 Forbidden: bot is suspended, 429 Too Many Requests, 400 Bad Request: <maydon>: … — xato kodlari.

Misol

Python
import os
import requests

TOKEN = os.environ["ZAMIN_BOT_TOKEN"]
API = f"https://api.zamin.app/bot{TOKEN}"

r = requests.get(f"{API}/getMe", timeout=15)
me = r.json()["result"]
print(f"@{me['username']} (id {me['id']}) ishlayapti")
curl
curl -s "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/getMe"