https://quickdl.appИзграждане на изтегляния с QuickDL
QuickDL позволява на разработчиците да инспектират компактния модел на заявка преди активирането.Поддръжката трябва да валидира продукта, преди частен ключ и квота да станат използваеми.
QuickDlJobsJSON през HTTPSАсинхронни работни местаОбхватни идентификационни данни
01
Бърз старт
В QuickDL, удостоверенията, активирани чрез поддръжка, са първи при обяснението на API хоста. Тази компактна помощна програма следва с назначен крайна точка на наемател и завършва с път за повикване само към сървър.
X-API-Key: pending_activation_…QuickDlJobsv1# 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 управлява безопасността на идентификационните данни, като първо идентифицира съхранението на тайни от страна на сървъра. След това не вгражда клиентски пакети и не поддържа публични дневници или хранилища на показ.
02
Разрешаване на връзка
В 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 обработва идентификатор на формат, като първо идентифицира върнатата стойност без промяна. Следва проверка на наличността за всяка връзка и не показва предполагаема етикет за качество.
03
Създаване и проследяване на задача за изтегляне
Компактният инструмент QuickDL преглежда асинхронната подготовка за създаване на задача. Той показва кратка HTTP заявка след това и не затъмнява изпълнението на свързания работник.
ПОС
/v1/jobsОбхват: работни места| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
public_link | HTTPS адрес | Да | Същият нормализиран източник, подаден за разрешаване. |
download_option | низ | Да | Точен идентификатор от отговора за разрешаване. |
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"}'quick_job.GET /v1/jobs/{quick_job} със същия ключ.| Състояние | Значение | Действие на клиента |
|---|---|---|
queued | Допуснат до ограничената опашка. | Анкета отново с отстъпление. |
extracting | Обновяване на изходните метаданни или маршрут. | Продължете да гласувате. |
processing | Изтегляне, ремиксиране или сливане. | Показване на напредъка на сървъра. |
ready | Подписано изтегляне е налично. | Изпратете адреса на потребителя. |
failed | Терминална структурирана грешка. | Прочетете error_codeПовторете опита само когато ви бъде препоръчано. |
expired | Временният изход беше премахнат. | Създаване на нова работа. |
curl https://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDL представя три практически точки за изслушване на работни места. Първо идва първоначално изчакване от една секунда. Компактната помощна програма след това покрива ограничено изоставане. Неговата последна точка е временно подписана доставка.
04
Предсказуеми грешки
QuickDL подхожда към договор за грешки чрез един конверт, който не е 2xx, след това чрез идентификатор на заявка за поддръжка. Компактната помощна програма поддържа предвидимо клиентско обработване изрично.
{
"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 | Невалиден адрес, тяло или недостъпен формат. | Коригирайте заявката. Решете отново за формати. |
| 401 | Липсва, невалиден, изтекъл или с грешен обхват ключ. | Проверете идентификационните данни от страна на сървъра. |
| 403 | Наемател или източник политика отхвърли искането. | Не заобикаляйте правилата. Свържете се с поддръжката. |
| 404 | Неизвестна или изтекла работа. | Създайте нова работа, ако е подходящо. |
| 429 | Достигане на ограничението за заявки или активни задачи. | Чест. retry_after_seconds. |
| 503 | Опашка/капацитет или нагоре по веригата временно недостъпни. | Опитайте отново с експоненциално отстъпление и трептене. |
05
Договор за експлоатация
QuickDL предоставя компактна, специфична за клиента квота, която поддържа интеграцията, без да дестабилизира услугите на източника.
- Използвайте idempotent логика на приложението и никога не започват дублирани работни места за един и същ потребител клик.
- Кешът разрешава метаданните за кратко, но винаги третира подписаните адреси за изтегляне като изтичащи.
- Използвайте ограничен експоненциален отстъп с трептене за
429,503и повторяеми грешки. - Обработвайте само публични медии или медии, до които имате разрешение за достъп. DRM и контролите за достъп не се заобикалят.
- Съхранявайте идентификационните номера на заявките и идентификационните номера на задачите в частни оперативни регистрационни файлове.
В QuickDL, активирането преди изследването е първо при обяснението на достъпа до Схема. Тази компактна помощна програма следва с назначена автентикация и завършва с документирани форми на заявки.
Активиране чрез поддръжка
Осигурете на QuickDL името на интеграцията, очаквания месечен обем и необходимите източници.Идентифицирайте операциите, които сървърът ще извърши, така че одобрението да произведе еднократен ключ с тесен обхват.
Заявка за активиране Ключовете са с обхват на наемателя, отменяеми и издадени чрез формата за връзка.Анонимните скриптове не могат да изпълняват работа за изтегляне.