sendAudio

Audio fayl yuboradi (MP3, M4A, OGG, WAV, FLAC …).

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

Audio yuboradi. Qo'llab-quvvatlanadi: MP3, M4A/AAC, OGG/Opus, WAV, FLAC, AIFF, AMR, CAF, WebM audio. Javobda audio maydoni bo'ladi.

M4A/AAC fayllar MP4 konteynerida bo'lgani uchun ular fayl nomining kengaytmasi (.m4a, .aac …) orqali audio deb taniladi. Multipart'da to'g'ri fayl nomini yuboring, aks holda fayl video deb aniqlanadi va type of file mismatch xatosi qaytadi.

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",
    "audio": {
      "file_id": "BQx8Kq2vN0aLrT5mW1pZcY7uE3sHdJ9gFbR4",
      "file_unique_id": "Au2sD4fG6hJ8kL0q",
      "file_size": 3145728,
      "mime_type": "audio/mpeg",
      "file_name": "qoshiq.mp3"
    }
  }
}

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

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

curl -s "https://api.zamin.app/bot$ZAMIN_BOT_TOKEN/sendAudio" \
  -F chat_id=4810235517 \
  -F caption="Mana fayl" \
  -F audio=@qoshiq.mp3

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.