سرویس آپلود فایل

یکی از رایج‌ترین نیازهای غرفه‌داران در باسلام، بارگذاری تصویر برای محصولاتشان است. این سرویس به شما امکان می‌دهد فایل‌هایی مانند تصویر، ویدیو، فایل‌های صوتی یا اسناد را به راحتی روی سرور باسلام آپلود کنید.

آپلود فایل جدید

این API برای بارگذاری یک فایل به سرور باسلام استفاده می‌شود و به عنوان نقطه‌ی ورودی تمام فرآیندهای وابسته به فایل (مانند تصویر محصول، ویدیوی معرفی، یا فایل‌های ارسالی در گفت‌وگو) عمل می‌کند.

در این درخواست، باید فایل موردنظر را همراه با پارامترهای تکمیلی مثل file_type یا expire_minutes به‌صورت multipart/form-data ارسال کنید.

در پاسخ موفق، اطلاعاتی مانند ID فایل، URL فایل و اندازه فایل در اختیار شما قرار می‌گیرد. URL فایل در سایر سرویس‌ها مانند ایجاد محصول، به‌روزرسانی پروفایل، غرفه یا غیره مورد استفاده قرار می‌گیرد.

پارامترهای ورودی

نام پارامتر	نوع	وضعیت	توضیح
`file`	`file`	اجباری	فایل موردنظر برای آپلود
`file_type`	`string`	اجباری	تایپ‌های معتبر برای بارگذاری: محصول: `product.photo`, `product.video` کاربر: `user.avatar`, `user.cover` غرفه: `vendor.logo`, `vendor.cover` گفت‌وگو: `chat.photo`, `chat.video`, `chat.voice`, `chat.file`
`custom_unique_name`	`string`	اختیاری	نام دلخواه و یکتا
`expire_minutes`	`integer`	اختیاری	زمان اعتبار فایل برحسب دقیقه. پس از این زمان فایل به صورت خودکار حذف خواهد شد. اگر مقدار داده نشود، فایل دائمی در نظر گرفته می‌شود.

فرمت‌های مجاز

نوع فایل	فرمت‌های پشتیبانی‌شده
تصویر	`jpg`, `jpeg`, `png`, `webp`, `gif`, `bmp`, `jfif`
ویدیو	`mp4`, `mov`, `3gp`, `m4v`, `mkv`, `flv`, `mpg`, `webm`, `mpeg`, `ts`, `avi`, `qt`, `m4a`
صوتی	`mp3`, `ogg`, `wav`
سند	`xls`, `xlsx`, `csv`, `pdf`

در هر درخواست فقط یک فایل قابل بارگذاری است.
حداکثر حجم مجاز برای تصویر 5MB، ویدئو 120MB و حداکثر مدت ویدئو 300 ثانیه است.

درخواست نمونه

curl -X POST https://uploadio.basalam.com/v3/files \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@test-image.jpg" \
  -F "file_type=product.photo" \
  -F "custom_unique_name=test_image_name" \
  -F "expire_minutes=120"

پاسخ موفق

{
  "id": 23xxxxxxx,
  "file_name": "tshirt-img.webp",
  "file_name_alone": "tshirt-img",
  "path": "users/5jzMN/07-02",
  "format": "webp",
  "mime_type": null,
  "type": "image",
  "file_type": 5901,
  "width": 1206,
  "height": 1809,
  "size": 14260,
  "duration": 0,
  "url": null,
  "urls": {
    "primary": "https://statics.basalam.com/public-102/users/5jzMN/07-02/tshirt-img.webp"
  },
  "created_at": "2025-07-02 15:25:37",
  "creator_user_id": 13xxxxx
}

جزئیات API و ارسال تستی درخواست

برای مشاهده‌ی دقیق مشخصات APIهای این سرویس، شامل ساختار کامل درخواست و پاسخ، انواع وضعیت‌های HTTP و همچنین امکان ارسال تستی درخواست در محیط تعاملی به صفحه مستندات APIهای این سرویس مراجعه کنید.

کیف پول وب‌هوک