Bot profili

setMyDescription

"Bu bot nima qila oladi?" matnini o'rnatadi.

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

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

Foydalanuvchi bot bilan chatni hali boshlamaganda ko'rsatiladigan tavsif. Parametr berilmasa yoki bo'sh bo'lsa, tavsif o'chiriladi.

Parametrlar

Parametr	Turi	Majburiy	Cheklov	Izoh
`description`	String	Ixtiyoriy	0–512 belgi	Berilmasa — tozalanadi.

Javob

Natija (result): true

JSON

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

Xatolar

Kod	Tavsif	Sabab va yechim
400	`Bad Request: description: …`	512 belgidan uzun.

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.post(
    f"{API}/setMyDescription",
    json={"description": "Men har kuni ertalab ob-havo ma'lumotini yuboraman. Boshlash uchun Start'ni bosing."},
    timeout=15,
)
print(r.json())

curl

curl -s -X POST "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/setMyDescription" \
  -H "Content-Type: application/json" \
  -d '{"description": "Men har kuni ertalab ob-havo ma'\''lumotini yuboraman."}'