Chatlar

getChatAdministrators

Guruh yoki kanalning egasi va adminlari (botlar ham).

POSThttps://api.zamin.app/bot<TOKEN>/getChatAdministrators

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

ChatMember massivini qaytaradi: egasi (creator), admin-odamlar va admin-botlar (administrator, huquqlari bilan). Odamlar psevdonim id bilan keladi — bu id'lar message.from.id bilan bir xil, shuning uchun "bu buyruqni admin yozdimi?" tekshiruvi uchun qulay.

Guruhda istalgan a'zo-bot chaqira oladi; kanalda bot doim admin. Natijani bir necha daqiqaga keshlang — har xabarda chaqirmang.

Parametrlar

Parametr	Turi	Majburiy	Cheklov	Izoh
`chat_id`	Integer yoki String	Majburiy	manfiy id yoki `@username`	Bot a'zo bo'lgan guruh yoki kanal: manfiy id (`message.chat.id`) yoki ochiq chatning `@username`'i. Shaxsiy chat id'si — `chat not found`.

Javob

Natija (result): Array of ChatMember

JSON

{
  "ok": true,
  "result": [
    {
      "user": {
        "id": 4810235517,
        "is_bot": false,
        "first_name": "Ali",
        "last_name": "Valiyev",
        "username": "ali",
        "language_code": "uz"
      },
      "status": "creator"
    },
    {
      "user": {
        "id": 5203318874,
        "is_bot": false,
        "first_name": "Vali",
        "username": "vali",
        "language_code": "uz"
      },
      "status": "administrator",
      "can_change_info": false,
      "can_delete_messages": true,
      "can_restrict_members": true,
      "can_invite_users": true,
      "can_pin_messages": true,
      "can_post_messages": false,
      "can_edit_messages": false,
      "can_promote_members": true,
      "can_manage_video_chats": false
    },
    {
      "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,
      "custom_title": "Moderator"
    }
  ]
}

Xatolar

Kod	Tavsif	Sabab va yechim
400	`Bad Request: chat not found`	Bunday chat yo'q, bot unda a'zo emas yoki bu shaxsiy chat id'si. Hammasi uchun javob bir xil (atayin).

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}"

GROUP_ID = int(os.environ["ZAMIN_GROUP_ID"])  # guruhning manfiy id'si (message.chat.id)

admins = requests.post(f"{API}/getChatAdministrators", json={"chat_id": GROUP_ID}, timeout=15).json()["result"]
admin_ids = {a["user"]["id"] for a in admins if not a["user"]["is_bot"]}
print("Adminlar:", admin_ids)

curl

curl -s -X POST "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/getChatAdministrators" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": -4012345678}'