sendPhoto

Rasm yuboradi (multipart yoki file_id).

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

Rasm yuboradi. Fayl mazmuni bo'yicha tekshiriladi (nomi yoki e'lon qilingan turi emas): JPEG, PNG, WebP, GIF, HEIC/HEIF, AVIF. Server rasmni qayta kodlaydi: 2048×2048 ichiga sig'diradi (kattalashtirmaydi), JPEG'ga o'tkazadi va EXIF ma'lumotlarini (jumladan GPS joylashuvni) olib tashlaydi. Shaffof joylar oq bo'ladi, GIF animatsiyasi saqlanmaydi.

Javobdagi photo massivida hozircha bitta PhotoSize bo'ladi.

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",
    "photo": [
      {
        "file_id": "BQx8Kq2vN0aLrT5mW1pZcY7uE3sHdJ9gFbR4",
        "file_unique_id": "Xk3pQ9vR2mLwT8aZ",
        "file_size": 183402,
        "width": 1280,
        "height": 960
      }
    ]
  }
}

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

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

curl -s "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/sendPhoto" \
  -F chat_id=4810235517 \
  -F caption="Mana fayl" \
  -F photo=@rasm.jpg

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.