این اندپوینت برای آپلود فایل در فضای ابری BoxAPI استفاده میشود و احراز هویت آن با هدر X-Api-Key انجام میشود.
پارامترهای درخواست
اطلاعات درخواست باید بهصورت multipart/form-data ارسال شود.
| نام | نوع | الزامی | توضیحات |
|---|---|---|---|
username |
string | بله | نام کاربری پیج اینستاگرامی که فایل برای آن استفاده خواهد شد. |
file |
file | بله | فایلی که میخواهید در فضای ابری BoxAPI آپلود کنید. |
type |
string | خیر | فرمت یا نوع فایل. ارسال این پارامتر اختیاری است. |
نمونه درخواست
curl -X POST "/service/uploads" \
-H "X-Api-Key: YOUR_API_KEY" \
-F "username=example_page" \
-F "file=@/path/to/file.jpg" \
-F "type=image/jpeg"محدودیت فضای ذخیرهسازی
فضای ذخیرهسازی فایلها بر اساس پلن کاربر محاسبه میشود. به ازای هر پیج یا اکانت مجاز در پلن، ۵۰۰ مگابایت فضای ذخیرهسازی در اختیار کاربر قرار میگیرد.
فضای کل قابل استفاده از فرمول زیر محاسبه میشود:
فضای ذخیرهسازی = تعداد اکانت مجاز در پلن × ۵۰۰ مگابایت| تعداد اکانت مجاز در پلن | فضای ذخیرهسازی |
|---|---|
| ۱ اکانت | ۵۰۰ مگابایت |
| ۵ اکانت | ۲.۵ گیگابایت |
| ۱۰ اکانت | ۵ گیگابایت |
| ۳۰ اکانت | ۱۵ گیگابایت |
نکته: این فضا بهصورت تجمیعی برای حساب کاربری در نظر گرفته میشود و بین اکانتهای متصل به آن حساب بهصورت جداگانه تفکیک نمیشود.
فرمتهای پشتیبانی شده برای آپلود و ارسال
| نوع فایل | فرمتهای پشتیبانیشده | حداکثر حجم |
|---|---|---|
audio |
AAC، M4A، WAV، MP4 |
25 MB |
image |
PNG، JPEG |
8 MB |
video |
MP4، OGG، AVI، MOV، WEBM |
25 MB |
file |
PDF |
25 MB |
فرمتها پشتیبانی شده و سایز فایل توسط متا تعیین شدهاند.
توجه : درصورت عدم تمدید پلن خود در BoxAPI، فایلهای شما تا ۳ روز نگهداری و میزبانی میشوند و پس از آن بهطور غیرقابل برگشت حذف خواهند شد.
همچنین امکان افزایش فضای ذخیرهسازی وجود دارد، برای افزایش فضا با پشتیبانی BoxAPI ارتباط برقرار کنید.