فایل‌ها
این بخش چه کار می‌کند؟
فایل‌ها و پوشه‌های حساب را مرور کنید و برای فایل آماده لینک دانلود بگیرید.
برای نمایش ویدیوهای همه پوشه‌ها، flatten=true&kind=video بفرستید.
پوستر و مشخصات صوتی و تصویری به‌صورت پیش‌فرض در پاسخ نمی‌آیند. برای دریافت آن‌ها، include_poster=true و include_media=true بفرستید.
زمان اعتبار لینک دانلود را از expires_at بخوانید. نشانی پوستر عمومی است و انقضای زمانی ندارد.
مراحل استفاده
- 1
مرور فایل‌ها و پوشه‌ها
فهرست به‌صورت پیش‌فرض فایل‌ها و پوشه‌های سطح اول حساب را نشان می‌دهد. با parent_id محتوای یک پوشه و با download_id فایل‌های یک دانلود را بگیرید.
GET/files— فهرست فایل‌ها و پوشه‌ها - 2
مشاهده مشخصات فایل
اطلاعات فایل، مشخصات صوتی و تصویری و وضعیت قفل بودن را بررسی کنید.
GET/files/{file}— دریافت جزئیات فایل یا پوشه - 3
همگام‌سازی کامل فایل‌ها
اگر نسخه‌ای از فایل‌ها را نزد خود نگه می‌دارید، بار اول بدون cursor همه فایل‌ها و پوشه‌ها را بگیرید و آخرین meta.next_cursor را ذخیره کنید. از آن به بعد، با همان cursor فقط تغییرات برمی‌گردد: موارد جدید یا تغییرکرده را با id جایگزین کنید و موارد deleted=true را حذف کنید؛ این‌ها حذف شده‌اند، در صف حذف‌اند یا دیگر جزو kind ارسالی شما نیستند. با خطای 410، بدون cursor از ابتدا شروع کنید.
GET/files/changes— دریافت تغییرات فایل‌ها برای همگام‌سازی - 4
ساخت لینک دانلود
برای دریافت لینک دانلود فایل، از download-link استفاده کنید.
POST/files/{file}/download-link— ایجاد لینک دانلود مستقیم - 5
ذخیره داده‌های برنامه برای فایل یا پوشه
داده‌هایی مثل موقعیت پخش ویدیو یا تنظیمات نمایش پوشه را در یک شیء JSON تا ۶۴ KiB ذخیره کنید. برای جلوگیری از بازنویسی ناخواسته تغییرات دستگاه دیگر، ETag پاسخ قبلی را در If-Match بفرستید.
PUT/files/{file}/state— ذخیره داده‌های برنامه برای فایل یا پوشه
endpointهای این بخش
برای مشاهده پارامترها، ساختار پاسخ‌ها و نمونه کدها، endpoint مورد نظر را انتخاب کنید.
- GETفهرست فایل‌ها و پوشه‌ها
/files - POSTایجاد پوشه جدید
/files/folder - POSTحذف گروهی فایل‌ها و پوشه‌ها
/files/delete - GETدریافت جزئیات فایل یا پوشه
/files/{file} - POSTایجاد لینک دانلود مستقیم
/files/{file}/download-link - GETدریافت داده‌های برنامه برای فایل یا پوشه
/files/{file}/state - PUTذخیره داده‌های برنامه برای فایل یا پوشه
/files/{file}/state - DELETEپاک کردن داده‌های برنامه برای فایل یا پوشه
/files/{file}/state - GETدریافت تغییرات فایل‌ها برای همگام‌سازی
/files/changes