Tugmalar

answerCallbackQuery

Inline tugma bosilishiga javob beradi: qisqa xabar, oyna yoki havola.

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

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

Foydalanuvchi inline tugmani bosganda bot CallbackQuery yangilanishini oladi. Unga shu metod bilan javob bering: bir marta va 60 soniya ichida. Javob faqat tugmani bosgan foydalanuvchiga ko'rinadi.

text — qisqa bildirishnoma;
show_alert: true — matn oyna (alert) ko'rinishida;
url — ilova havolani ochishni taklif qiladi (avval tasdiq so'raladi).

Guruhda ham shunday: botning guruhdagi xabaridagi tugmani istalgan a'zo bosishi mumkin, javob esa faqat bosgan odamga ko'rinadi. Kanal postlarida tugma yo'q.

Parametrlar

Parametr	Turi	Majburiy	Cheklov	Izoh
`callback_query_id`	String	Majburiy	≤64 belgi	`callback_query.id`.
`text`	String	Ixtiyoriy	0–200 belgi
`show_alert`	Boolean	Ixtiyoriy	—	Standart: false.
`url`	String	Ixtiyoriy	≤2048 belgi	Faqat http/https. zamin.app havolalari faqat `https://zamin.app/<username>?start=…` ko'rinishida (URL qoidalari).
`cache_time`	Integer	Ixtiyoriy	—	Qabul qilinadi, lekin e'tiborga olinmaydi.

Javob

Natija (result): true

JSON

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

Xatolar

Kod	Tavsif	Sabab va yechim
400	`Bad Request: query is too old and response timeout expired or query ID is invalid`	60 soniya o'tgan, javob allaqachon berilgan yoki id noto'g'ri.
400	`Bad Request: url: URL is not allowed`	URL qoidalarga mos emas.

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

def on_callback(query):
    # Avval tezda javob bering (60 soniya ichida, bir marta)
    requests.post(
        f"{API}/answerCallbackQuery",
        json={"callback_query_id": query["id"], "text": "Qabul qilindi ✅"},
        timeout=15,
    )
    print("Tugma:", query["data"], "chat:", query["message"]["chat"]["id"])

curl

curl -s -X POST "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/answerCallbackQuery" \
  -H "Content-Type: application/json" \
  -d '{"callback_query_id": "q7Lm2xYp9RtVb4Nw", "text": "Qabul qilindi ✅"}'