معرفی و توضیحات9 endpoint

دانلودها

این بخش چه کار می‌کند؟

لینک یا فایل تورنت و یوزنت را ثبت کنید، پیشرفت دانلود را ببینید و پس از تکمیل، جزئیات فایل و لینک دانلود را دریافت کنید.

ایجاد دانلود برای بعضی از لینک‌ها به انتخاب کاربر نیاز دارد. برای مثال، پس از ارسال لینک یوتیوب، ابتدا کیفیت‌های موجود نمایش داده می‌شوند و دانلود تا زمان انتخاب کیفیت آغاز نمی‌شود. در این حالت، پاسخ شامل data.kind=selection است و گزینه‌های قابل انتخاب را در data.selection.items برمی‌گرداند.

مراحل استفاده

  1. 1

    ثبت دانلود

    لینک را با JSON به POST /downloads بفرستید. فایل تورنت یا یوزنت را با multipart/form-data به POST /downloads/upload بفرستید.

    POST/downloads— ایجاد دانلود جدید
  2. 2

    انتخاب فایل یا کیفیت (در صورت نیاز)

    اگر data.kind=selection بود، گزینه‌ها را به کاربر نشان دهید. شناسه گزینه انتخاب‌شده را پیش از expires_at در item_id بفرستید؛ selectable آن باید true باشد. ممکن است پاسخ به انتخاب دیگری نیاز داشته باشد.

    POST/download-selections/{selection}/choices— ثبت انتخاب کاربر و ادامه دانلود
  3. 3

    پیگیری پیشرفت

    پس از دریافت data.kind=download، وضعیت را با شناسه دانلود پیگیری کنید. وب‌هوک نتیجه دانلود، شامل تکمیل، خطا یا لغو آن را می‌فرستد.

    GET/downloads/{download}— دریافت جزئیات دانلود
  4. 4

    دریافت جزئیات فایل و لینک دانلود

    وقتی status برابر completed شد، با file_id مشخصات فایل را از GET /files/{file} بگیرید. برای دریافت لینک دانلود، POST /files/{file}/download-link را فراخوانی کنید.

endpointهای این بخش

برای مشاهده پارامترها، ساختار پاسخ‌ها و نمونه کدها، endpoint مورد نظر را انتخاب کنید.

9