فایل و رسانه

ارسال عکس

curl -X POST "https://api.uniom.ir/bot<API_KEY>/sendPhoto" \
  -F "chat_id=@username" \
  -F "caption=تصویر تست" \
  -F "photo=@./image.jpg"

برای فایل‌هایی که قبلاً در پلتفرم شناخته شده‌اند، ممکن است بتوانید به جای upload از file id یا URL پشتیبانی‌شده استفاده کنید.

ارسال سند

curl -X POST "https://api.uniom.ir/bot<API_KEY>/sendDocument" \
  -F "chat_id=@username" \
  -F "document=@./report.pdf"

ارسال چند رسانه

curl -X POST "https://api.uniom.ir/bot<API_KEY>/sendMediaGroup" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "@username",
    "media": [
      {"type": "photo", "media": "https://example.com/a.jpg"},
      {"type": "photo", "media": "https://example.com/b.jpg"}
    ]
  }'

گرفتن فایل

ابتدا getFile را صدا بزنید:

curl "https://api.uniom.ir/bot<API_KEY>/getFile?file_id=<FILE_ID>"

اگر پاسخ شامل file_path باشد، فایل از مسیر زیر دریافت می‌شود:

https://api.uniom.ir/file/bot<API_KEY>/<file_path>

نکته برای production

برای uploadهای بزرگ، timeout کلاینت HTTP و retry را مشخص تنظیم کنید. اگر upload ناموفق شد، همان درخواست را بی‌نهایت تکرار نکنید؛ ابتدا وضعیت پیام و لاگ درخواست را بررسی کنید.