ZaminDocs

Chatlar

leaveChat

Bot guruh yoki kanaldan o'zi chiqadi.

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

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

Bot guruhdan yoki kanaldan chiqadi. Guruhda a'zolar "bot chiqdi" xizmat xabarini ko'radi, botning shu guruhdagi shifrlash kaliti bekor qilinadi. Bot my_chat_member (→ left) yangilanishini oladi. Qaytib kirish uchun uni yana admin qo'shishi kerak.

Kanal izohlari chati id'si bilan chaqirilsa — 400: izohlar chati kanalga tegishli, chiqish uchun kanal id'sini bering.

Parametrlar

ParametrTuriMajburiyCheklovIzoh
chat_idInteger yoki StringMajburiymanfiy id yoki @usernameBot 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): true

JSON
{"ok": true, "result": true}

Xatolar

KodTavsifSabab va yechim
400Bad Request: chat not foundBunday chat yo'q, bot unda a'zo emas yoki bu shaxsiy chat id'si. Hammasi uchun javob bir xil (atayin).
400Bad Request: can't leave the comments chat; leave the channel insteadIzohlar chati id'si berildi.

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"])

print(requests.post(f"{API}/leaveChat", json={"chat_id": GROUP_ID}, timeout=15).json())
curl
curl -s -X POST "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/leaveChat" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": -4012345678}'