sendDocument

Istalgan faylni hujjat sifatida yuboradi.

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

Istalgan turdagi faylni hujjat sifatida yuboradi. Javobda doim document maydoni bo'ladi. Fayl nomi saqlanadi (120 belgigacha; rasmlarda nom saqlanmaydi).

mime_type fayl mazmunidan aniqlanadi. Rasm, video va audio bo'lmagan fayllar uchun u doim application/octet-stream bo'ladi (PDF uchun ham). Fayl turini file_name'dan aniqlang. Rasm hujjat sifatida yuborilsa ham qayta kodlanadi (JPEG).

Parametrlar

Javob

Natija (result): Message

{
  "ok": true,
  "result": {
    "message_id": 14,
    "from": {
      "id": 1000001,
      "is_bot": true,
      "first_name": "Ob-havo",
      "username": "ObHavoBot",
      "can_join_groups": true,
      "can_read_all_group_messages": false,
      "supports_inline_queries": false
    },
    "chat": {
      "id": 4810235517,
      "type": "private",
      "first_name": "Ali",
      "last_name": "Valiyev",
      "username": "ali"
    },
    "date": 1791106200,
    "caption": "Mana fayl",
    "document": {
      "file_id": "BQx8Kq2vN0aLrT5mW1pZcY7uE3sHdJ9gFbR4",
      "file_unique_id": "Pq7wE2rT9yU4iO1a",
      "file_size": 52144,
      "mime_type": "application/octet-stream",
      "file_name": "hisobot.pdf"
    }
  }
}

Xatolar

Istalgan metodda bo'lishi mumkin: 401 Unauthorized, 403 Forbidden: bot is suspended, 429 Too Many Requests, 400 Bad Request: <maydon>: … — xato kodlari.

Misol

import os
import requests

TOKEN = os.environ["ZAMIN_BOT_TOKEN"]
API = f"https://api.zamin.app/bot{TOKEN}"
CHAT_ID = int(os.environ["ZAMIN_CHAT_ID"])  # getUpdates javobidagi message.chat.id

with open("hisobot.pdf", "rb") as f:
    r = requests.post(
        f"{API}/sendDocument",
        data={"chat_id": CHAT_ID, "caption": "Mana fayl"},
        files={"document": ("hisobot.pdf", f, "application/pdf")},
        timeout=60,
    )
data = r.json()
print(data)

# Keyingi safar o'sha faylni qayta yuklamasdan, file_id bilan yuborish mumkin:
file_id = data["result"]["document"]["file_id"]
requests.post(f"{API}/sendDocument", json={"chat_id": CHAT_ID, "document": file_id}, timeout=15)

curl -s "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/sendDocument" \
  -F chat_id=4810235517 \
  -F caption="Mana fayl" \
  -F document=@hisobot.pdf

Guruh va kanalda

• Guruh (chat_id manfiy): Fayl guruhning barcha a'zolari telefonlari uchun uchidan-uchiga shifrlanadi (boshqa botlar uni ko'rmaydi). Faqat inline klaviatura. Bot admin bo'lmasa, guruhning a'zolar uchun ruxsatlari amal qiladi. reply_to_message_id — guruhdagi xabar raqami.
• Kanal: botda can_post_messages huquqi bo'lishi kerak, bot egasi esa Zamin foydalanish shartlarini qabul qilgan bo'lishi kerak; matn odamlarning postlari kabi kontent filtridan o'tadi. Post oddiy kanal posti bo'lib chiqadi (obunachilarga bildirishnoma boradi), javobda sender_chat bor, from yo'q. Tugmalar yo'q (reply_markup → 400), reply_to_message_id e'tiborga olinmaydi.
• Kanal izohlari chati: bot izoh yoza olmaydi (400 method is not available for this chat).
• Limit: bitta guruh yoki kanalga daqiqasiga 20 ta xabar; guruhda — shifrlash byudjeti ham (xabar har bir odamning eng so'nggi faol 10 ta qurilmasiga shifrlanadi). Limitlar.

Guruhga yuborilgan fayl server tomonidan tekshiriladi va qayta kodlanadi (shaxsiy chatdagidek), so'ng uchidan-uchiga shifrlab saqlanadi; kalit faqat a'zolar telefonlariga va botning o'ziga boradi. Guruhda olingan file_id'ni boshqa guruh yoki kanalga yuborish mumkin, lekin shaxsiy chatga emas (wrong file identifier). Guruh yoki kanalga file_id bilan qayta yuborish ham, multipart yuklash ham (shaxsiy chatda ham) bir vaqtdagi fayl uzatish limitiga kiradi: bot bo'yicha 3 ta, umumiy 16 ta (429, retry_after: 1). Guruhdagi fayllar.