مستندات SDK
پایتون
آپلود

سرویس آپلود

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

فهرست مطالب

متدهای آپلود

متدتوضیحاتپارامترها
upload_file()آپلود یک فایلfile, file_type, custom_unique_name, expire_minutes

پارامترها

  • 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
)

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

گفت‌وگوکیف پول