دانلودها
دریافت گزینههای دانلود
GET
https://api.parsget.com/api/v1/download-selections/{selection}OAuth یا Personal API Keyمقدار Access Token یا Personal API Key را با قالب Bearer TOKEN در هدر Authorization بفرستید.
برای پیگیری درخواست در لاگها، یک شناسه بین ۱ تا ۱۰۰ کاراکتر بفرستید. اگر این هدر را نفرستید، سرور شناسه میسازد.
هدرهای استانداردبعضی لینکها پیش از ایجاد دانلود به انتخاب کاربر نیاز دارند؛ مثلاً انتخاب کیفیت ویدیو یا فایلهای داخل تورنت. اگر پاسخ ثبت دانلود شامل data.kind=selection بود، میتوانید با شناسه آن، فهرست گزینهها را دوباره دریافت و به کاربر نمایش دهید.
از همان حساب و همان Personal API Key یا برنامه OAuth استفاده کنید که مرحله انتخاب را ایجاد کرده است. شناسه نامعتبر، منقضی یا متعلق به حساب یا کلید دیگری، پاسخ 404 با کد download_selection_not_found میدهد. اگر انتخاب این مرحله قبلاً ثبت شده باشد، پاسخ 409 با کد download_selection_already_resolved میگیرید.
Parameters
| Field | Type | Description |
|---|---|---|
selection | string · pathrequired | شناسه مرحله انتخاب از data.selection.id پاسخ ایجاد دانلود یا انتخاب قبلی. |
Response schema
200اطلاعات مرحله انتخاب فایل
Payload
object| Field | Type | Description |
|---|---|---|
kind | stringselection | — |
selection | object | |
id | string | — |
prompt | string | عنوان یا راهنمای مرحله انتخاب برای نمایش به کاربر |
expires_at | stringdate-time | مهلت انتخاب کاربر. پس از این زمان، شناسه مرحله و گزینههای آن معتبر نیستند. |
items | object[] | |
id | string | شناسه گزینه در مرحله انتخاب فعلی. |
parent_id | string | شناسه گزینهای که این مورد زیرمجموعه آن است. برای گزینههای سطح اول، null است. |
name | string | — |
size_bytes | integerint64min 0 | — |
kind | stringdirectoryvideoaudioimagedocumentnull | — |
status | stringnonesubmittedreadynull | — |
tags | Record<string, string> | — |
thumbnail_url | stringuri | — |
selectable | boolean | اگر true باشد، کاربر میتواند این گزینه را انتخاب کند. |
پاسخهای خطاساختار استاندارد
error