sendVideo

Video yuboradi (MP4, MOV, WebM).

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

Video yuboradi. Fayl mazmuni bo'yicha video bo'lishi kerak: MP4, QuickTime (MOV) yoki WebM. Javobda video maydoni bo'ladi. Davomiylik, eskiz (thumbnail) kabi maydonlar hozircha yo'q.

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",
    "video": {
      "file_id": "BQx8Kq2vN0aLrT5mW1pZcY7uE3sHdJ9gFbR4",
      "file_unique_id": "Vd5tG8hJ1kL3zX6c",
      "file_size": 4823011,
      "mime_type": "video/mp4",
      "file_name": "video.mp4"
    }
  }
}

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("video.mp4", "rb") as f:
    r = requests.post(
        f"{API}/sendVideo",
        data={"chat_id": CHAT_ID, "caption": "Mana fayl"},
        files={"video": ("video.mp4", f, "video/mp4")},
        timeout=60,
    )
data = r.json()
print(data)

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

curl -s "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/sendVideo" \
  -F chat_id=4810235517 \
  -F caption="Mana fayl" \
  -F video=@video.mp4

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.