Ainult eelvaade – nõutav aktiveerimine

Ehitage allalaadimised koos QuickDL-ga

QuickDL võimaldab arendajatel enne aktiveerimist kontrollida kompaktset taotluse mudelit. Tugiteenus peab toote valideerima enne, kui privaatvõti ja kvoot muutuvad kasutatavaks.

QuickDlJobsJSON HTTPS-i kauduAsünkroonsed töökohadKohaldamisalaga identimisteave

Kiire algus

QuickDL-s on API-hosti selgitamisel kõigepealt tugiteenuse aktiveeritud mandaadid. See kompaktne utiliit järgneb määratud rentniku lõpp-punktiga ja sulgub ainult serveri kõne teel.

Rentniku URLhttps://quickdl.app

AutentimineX-API-Key: pending_activation_…

Kliendi profiilQuickDlJobs

API versioonv1

# 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 käsitleb Credential turvalisust, tuvastades kõigepealt serveripoolse salajase salvestuse. See järgneb ilma kliendikimpude manustamiseta ja ei hoia ühtegi avalikku logit ega hoidla vaateväljas.

Lingi lahendamine

QuickDL-s on Resolve'i toimingu selgitamisel kõigepealt allika tuvastamine See kompaktne utiliit järgib ühest esitatud URL-ist pärit vorminguid ja sulgeb väljamõeldud väljundite puudumisel.

POST/v1/resolveReguleerimisala: lahendada

Väli	Tüüp	Nõutav	Kirjeldus
`public_link`	HTTPS URL	Jah	Avalik või volitatud meedia leht analüüsimiseks.
`tenant`	string	Ei	Määratud rentniku domeen. Tavaliselt jäetakse välja.

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

QuickDL käsitleb vormingu identifikaatorit, tuvastades esmalt tagastatud väärtuse muutumatuna. See järgneb lingipõhise kättesaadavusega ja ei hoia ühtegi arvatud kvaliteedisilti silmas.

Allalaadimistöö loomine ja jälgimine

QuickDL kompaktne utiliit vaatab üle asünkroonse ettevalmistuse Töö loomiseks. See näitab lühikest HTTP-taotlust järgmisena ja ei varja piiratud töötaja täitmist.

POST/v1/jobsReguleerimisala: töökohad

Väli	Tüüp	Nõutav	Kirjeldus
`public_link`	HTTPS URL	Jah	Sama normaliseeritud allikas esitati lahendamiseks.
`download_option`	string	Jah	Täpne ID lahendamisvastusest.
`tenant`	string	Ei	Määratud rentniku domeen. Tavaliselt jäetakse välja.

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 AktsepteeritudSalvesta quick_job.

2Küsitluse staatusGET /v1/jobs/{quick_job} sama võtmega.

3ValmisAvage allkirjastatud allalaadimise URL.

Olek	Tähendus	Kliendi tegevus
`queued`	Lubatud piiratud järjekorda.	Küsitlus uuesti tagasilöögiga.
`extracting`	Värskendatakse lähtemetaadata või marsruuti.	Jätkake küsitlemist.
`processing`	Allalaadimine, remuxing või ühendamine.	Kuva serveri edenemine.
`ready`	Allkirjastatud allalaadimine on saadaval.	Saada URL kasutajale.
`failed`	Terminali struktureeritud viga.	Loe `error_code`Proovige uuesti ainult siis, kui seda soovitatakse.
`expired`	Ajutine väljund eemaldati.	Looge uus töökoht.

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

QuickDL esitab kolm praktilist punkti Töö küsitlus. Esiteks tuleb ühe sekundi algne ootamine. Kompaktne utiliit katab seejärel piiratud tagasilöögi. Selle lõpppunkt on ajutine allkirjastatud tarne.

Eeldatavad vead

QuickDL läheneb Vealepingule ühe mitte-2xx ümbriku kaudu, seejärel tugiteenuse taotluse ID. Kompaktne utiliit hoiab prognoositava kliendi käsitsemise selgesõnaliselt.

{
  "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	Tüüpiline tähendus	Tegevus
400	Vigane URL, keha või kättesaamatu vorming.	Parandage taotlus. Lahendage uuesti vormingute jaoks.
401	Puuduv, kehtetu, aegunud või vale ulatusega võti.	Kontrollige serveripoolset mandaati.
403	Üürnik või allikapoliitika lükkas taotluse tagasi.	Ärge mööduge poliitikast. Võtke ühendust toega.
404	Tundmatu või aegunud töö.	Looge vajadusel uus töökoht.
429	Taotluste või aktiivsete tööde piirmäär on saavutatud.	Au. `retry_after_seconds`.
503	Järjekord/mahutavus või ülesvoolu ajutiselt kättesaamatu.	Proovige uuesti eksponentsiaalse tagasilöögi ja värisemisega.

Tegevusleping

QuickDL annab kompaktse, kliendipõhise kvoodi, mis toetab integratsiooni ilma allikateenuseid destabiliseerimata.

Kasutage idempotentset rakendusloogikat ja ärge kunagi käivitage sama kasutaja kliki jaoks duplikaattöid.
Puhverda lahendamise metaandmeid lühidalt, kuid käsitle allkirjastatud allalaadimise URL-e alati kui aeguvat.
Kasutage piiratud eksponentsiaalset tagasilööki koos värisemisega 429, 503 ja korratavaid vigu.
Töötle ainult avalikku meediat või meediat, millele sul on lubatud juurde pääseda. DRM- ja juurdepääsukontrolle ei mööda.
Hoidke päringute ID-d ja tööde ID-d privaatses operatiivlogides. Ärge logige esitatud URL-e tarbetult.

QuickDL-s on aktiveerimine enne uurimist Schema juurdepääsu selgitamisel kõigepealt See kompaktne utiliit järgneb määratud autentimisega ja sulgub dokumenteeritud taotluskujunditel.

ETTEVÕTJA LÄBIVAATAMINE

Aktiveerimine tugiteenuse kaudu

Andke QuickDL-le integratsiooni nimi, eeldatav igakuine maht ja vajalikud allikad. Tuvastage serveri teostatavad toimingud, et kinnitamine tekitaks kitsa ulatusega ühekordse võtme.

Taotle aktiveerimist Võtmed on üürniku ulatuses, tühistatavad ja väljastatakse kontaktivormi kaudu. Anonüümsed skriptid ei saa alla laadija tööd käivitada.