Bot profili
setMyShortDescription
Qisqa ma'lumot ("about") matnini o'rnatadi.
POST
https://api.zamin.app/bot<TOKEN>/setMyShortDescriptionGET ham ishlaydi. Parametrlar: query, JSON, form yoki multipart — batafsil.
Bot profilida va ochiq sahifada (zamin.app/<bot>) ko'rinadigan qisqa matn. @ZaminBot'dagi /setabout bilan bir xil. Berilmasa yoki bo'sh bo'lsa — tozalanadi.
Parametrlar
| Parametr | Turi | Majburiy | Cheklov | Izoh |
|---|---|---|---|---|
short_description | String | Ixtiyoriy | 0–120 belgi | Berilmasa — tozalanadi. |
Javob
Natija (result): true
JSON
{"ok": true, "result": true}Xatolar
| Kod | Tavsif | Sabab va yechim |
|---|---|---|
| 400 | Bad Request: short_description: … | 120 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}/setMyShortDescription", json={"short_description": "Kunlik ob-havo ☀️"}, timeout=15)
print(r.json())curl
curl -s -X POST "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/setMyShortDescription" \
-H "Content-Type: application/json" \
-d '{"short_description": "Kunlik ob-havo ☀️"}'