سرویس آپلود

این سرویس قابلیت‌های آپلود امن فایل فراهم می‌کند: آپلود امن فایل‌ها، پشتیبانی از انواع مختلف فایل (تصاویر، اسناد، ویدیوها)، تنظیم نام‌های سفارشی فایل و زمان انقضا، دریافت URL فایل‌ها برای دسترسی.

فهرست مطالب

• متدهای آپلود
• مثال‌ها

متدهای آپلود

پارامترها

• file - آبجکت فایل (file handle, BytesIO, و غیره)
• file_type - نوع فایل (از UserUploadFileTypeEnum). انواع تایپ فایل قابل بارگذاری:
  • محصول: product.photo, product.video
  • کاربر: user.avatar, user.cover
  • غرفه: vendor.logo, vendor.cover
  • گفت‌وگو: chat.photo, chat.video, chat.voice, chat.file
• custom_unique_name - نام سفارشی برای فایل (اختیاری)
• expire_minutes - زمان انقضا به دقیقه (اختیاری)

مثال‌ها

پیکربندی اولیه

from basalam_sdk import BasalamClient, PersonalToken
 
auth = PersonalToken(
    token="your_access_token",
    refresh_token="your_refresh_token"
)
client = BasalamClient(auth=auth)

آپلود فایل

from basalam_sdk.upload.models import UserUploadFileTypeEnum
 
with open("image.png", "rb") as file:
    response = client.upload_file(
        file=file,
        file_type=UserUploadFileTypeEnum.PRODUCT_PHOTO
    )
  return response

نمونه پاسخ

پاسخ آپلود توسط مدل FileResponse هندل می‌شود:

FileResponse(
  id=238300331,
  file_name='image.png',
  file_name_alone='image',
  path='users/b28/07-13',
  format='png',
  type='image',
  file_type=5901,
  width=228,
  height=154,
  size=58007,
  duration=0,
  urls={'primary': '...'},
  created_at='2025-07-13 14:07:47',
  creator_user_id=430,
  mime_type=None,
  url=None
)

برای مشاهده فرمت‌های معتبر آپلود فایل به این سند مراجعه کنید.