Bot profili

setMyName

Botning ko'rinadigan nomini o'zgartiradi.

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

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

Botning ko'rinadigan nomi (username emas). Nom push-bildirishnomalar sarlavhasida ham ko'rinadi, shuning uchun tasdiqlanmagan botlar "Zamin"ga o'xshash nomlarni ola olmaydi (jumladan kirill yoki o'xshash belgilar bilan yozilganlari: "ZАMIN", "Z a m i n", "Замин").

Parametrlar

Parametr	Turi	Majburiy	Cheklov	Izoh
`name`	String	Majburiy	1–64 belgi	Bosh va oxiridagi bo'shliqlar olib tashlanadi. `language_code` e'tiborga olinmaydi.

Javob

Natija (result): true

JSON

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

Xatolar

Kod	Tavsif	Sabab va yechim
400	`Bad Request: this name is reserved`	Nomda "Zamin" (yoki unga o'xshash yozuv) bor.
400	`Bad Request: name: …`	Nom bo'sh yoki 64 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}"

print(requests.post(f"{API}/setMyName", json={"name": "Ob-havo"}, timeout=15).json())

curl

curl -s -X POST "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/setMyName" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ob-havo"}'