Само преглед — потребна е активација

Изградете преземања со QuickDL

QuickDL им овозможува на развивачите да го прегледаат компактниот модел на барање пред активирање. Поддршката мора да го верификува производот пред приватен клуч и квота да станат употребливи.

QuickDlJobsJSON преку HTTPSАсинхрони задачиОбемни акредитиви

Брз почеток

Во QuickDL, активацијата на поддржани креденцијали доаѓа прва при објаснување на API домаќинот. Тоа компактно средство следи со доделена крајна точка на закупец и завршува со патека за повик само на сервер.

URL на закупецhttps://quickdl.app

Проверка за автентичностX-API-Key: pending_activation_…

Профил на клиентQuickDlJobs

Верзија на APIv1

# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"

curl -X POST https://quickdl.app/v1/resolve \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'

QuickDL ја ракува безбедноста на акредитивите прво со идентификување на серверската тајна складиште. Потоа не вградува клиентски пакет и не чува јавни записи или репозитории на видик.

Решете врска

Во QuickDL, откривањето на изворот доаѓа прво при објаснување на операцијата Resolve. Таа компактна алатка продолжува со формати од еден поднесен URL и завршува без измислени излези.

ПОШТА/v1/resolveОпсег: решавање

Поле	Тип на датотека	Задолжително	Опис
`public_link`	HTTPS адреса	Да	Јавна или овластена страница на медиумите за анализа.
`tenant`	низа	Не.	Доделен домен на закупецот.Обично се испушта.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

QuickDL ракува со идентификатор на формат прво идентификувајќи ја вратената вредност непроменета. Следи достапност по врска и не задржува претпоставена ознака за квалитет во вид.

Креирајте и следете работа за преземање

Компактната алатка на QuickDL ги прегледува асинхроните подготовки за создавање на работни места. Прикажува краток HTTP барање следно и не го прикрива извршувањето на ограничениот работник.

ПОШТА/v1/jobsОпсег: работни места

Поле	Тип на датотека	Задолжително	Опис
`public_link`	HTTPS адреса	Да	Истиот нормализиран извор поднесен за решавање.
`download_option`	низа	Да	Точен ID од одговорот за решавање.
`tenant`	низа	Не.	Доделен домен на закупецот.Обично се испушта.

curl -X POST https://quickdl.app/v1/jobs \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'

1202 ПрифатеноЗачувај quick_job.

2Статус на анкетатаGET /v1/jobs/{quick_job} со истиот клуч.

3ПодготвенОтворете ја потпишаната URL за преземање.

Статус	Значење	Дејство на клиентот
`queued`	Прифатено во ограничената редица.	Анкета повторно со повраток.
`extracting`	Освежување на изворните метаподатоци или рутата.	Продолжете со анкетирање.
`processing`	Преземање, ремуксирање или спојување.	Прикажи напредок на серверот.
`ready`	Потпишано преземање е достапно.	Испратете го URL-то до корисникот.
`failed`	Грешка во структурата на терминалот.	Прочитај `error_code`.Повторете го обидот само кога ќе бидете советувани.
`expired`	Привремениот излез беше отстранет.	Креирајте нова работа.

curl https://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL претставува три практични точки за анкета за работа. Прво доаѓа едносекундно почетно чекање. Компактната алатка потоа ги покрива ограничените повлекувања. Нејзината последна точка е привремена потпишана испорака.

Предвидливи грешки

QuickDL пристапува до Договор за грешка преку еден не-2xx коверт, потоа преку ID на барање за поддршка. Компактната алатка го одржува предвидливото ракување со клиентот експлицитно.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	Типично значење	Акција
400	Невалидна URL, тело или недостапен формат.	Поправете го барањето. Обидете се повторно за формати.
401	Клучот недостасува, е невалиден, истечен или со погрешен опсег.	Проверете ги акредитивите на страната на серверот.
403	Политиката на станарот или изворот го одби барањето.	Не заобиколувајте ја политиката.Контактирајте со поддршката.
404	Непозната или истечена работа.	Креирајте нова работа ако е соодветно.
429	Достигнато е ограничувањето на барањето или активната задача.	Чест. `retry_after_seconds`.
503	Ред/капацитет или горен тек привремено недостапен.	Повторете со експоненцијално повлекување и треперење.

Договор за работење

QuickDL доделува компактна, специфична за клиентот квота која ја поддржува интеграцијата без да ги дестабилизира изворните услуги.

Користете идемпотентна логика на апликацијата и никогаш не започнувајте дупликатни задачи за истиот клик на корисникот.
Кешот ги решава метаподатоците накратко, но секогаш ги третира потпишаните URL-адреси за преземање како истекување.
Користете ограничен експоненцијален поврат со тресење за 429, 503 и повторливи грешки.
Обработувајте само јавни медиуми или медиуми до кои имате овластување за пристап. DRM и контролите на пристап не се заобиколуваат.
Чувајте ги идентификаторите на барања и идентификаторите на задачи во приватни оперативни дневници. Не ги запишувајте испратените URL-адреси непотребно.

Во QuickDL, активацијата пред истражувањето доаѓа прва при објаснување на пристапот до Шема. Тоа компактно средство следи со доделена автентикација и завршува со документирани форми на барања.

ПРИСТАП КОНТРОЛИРАН ОД ОПЕРАТОР

Активирајте преку поддршка

Обезбедете му на QuickDL име на интеграција, очекуван месечен обем и потребни извори. Идентификувајте ги операциите што серверот ќе ги извршува за да одобрувањето произведе тесно насочен, еднократен клуч.

Побарајте активирање Клучевите се со опсег на закупец, се отповикливи и се издаваат преку формуларот за контакт. Анонимните скрипти не можат да извршат работа на преземач.