Vetëm parashikim — kërkohet aktivizimi

Ndërto shkarkimet me QuickDL

QuickDL lejon zhvilluesit të inspektojnë modelin e kërkesës kompakte përpara aktivizimit. Mbështetja duhet të vërtetojë produktin para se një çelës privat dhe kuotë të bëhen të përdorshëm.

QuickDlJobsJSON mbi HTTPSPunë asinkroneKredenciale me shtrirje

Fillimi i shpejtë

Në QuickDL, kredencialet e aktivizuara me mbështetje vijnë të parat kur shpjegohet hosti i API-së. Ai mjet kompakt vazhdon me një pikë përfundimi të caktuar për qiramarrës dhe përfundon me një rrugë thirrjeje vetëm për server.

URL e llogaritësithttps://quickdl.app

AutentifikimiX-API-Key: pending_activation_…

Profili i klientitQuickDlJobs

Versioni i 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 trajton sigurinë e Kredencialeve duke identifikuar së pari ruajtjen sekrete në anën e serverit. Më pas nuk përfshin paketim klienti dhe nuk mban asnjë regjistër publik apo depo në shikim.

Zgjidh një lidhje

Në QuickDL, zbulimi i burimit vjen i pari kur shpjegohet operacioni Resolve. Ajo shërbim i përmbledhur ndjek me formatet nga një URL e dorëzuar dhe mbyllet pa asnjë dalje të shpikur.

POST/v1/resolveFusha e veprimit: zgjidh

Fusha	Lloji	I domosdoshëm	Përshkrimi
`public_link`	URL HTTPS	Po	Faqe publike ose e autorizuar e mediave për të analizuar.
`tenant`	varg	Jo.	Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë.

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

QuickDL trajton Identifikuesin e Formatit duke identifikuar së pari vlerën e kthyer pa ndryshuar. Më pas ndjek disponueshmërinë për lidhje dhe nuk mban asnjë etiketë cilësie të supozuar në shikim.

Krijoni dhe ndiqni një punë shkarkimi

QuickDL: kompakte utilitar rishikon përgatitjen asinkrone për krijimin e Punës. Ajo tregon një kërkesë të shkurtër HTTP në vijim dhe nuk e zbeh ekzekutimin e kufizuar të punëtorëve.

POST/v1/jobsFusha e veprimit: punët

Fusha	Lloji	I domosdoshëm	Përshkrimi
`public_link`	URL HTTPS	Po	I njëjti burim i normalizuar i paraqitur për të zgjidhur.
`download_option`	varg	Po	Një ID e saktë nga përgjigja e zgjidhjes.
`tenant`	varg	Jo.	Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë.

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

2Gjendja e sondazhitGET /v1/jobs/{quick_job} me të njëjtin çelës.

3GatiHapni URL-në e nënshkruar të shkarkimit.

Gjendja	Kuptimi	Veprimi i klientit
`queued`	pranohet në radhën e kufizuar.	Sondazh përsëri me prapambetje.
`extracting`	Rifreskim i metatë dhënave të burimit ose rrugës.	Vazhdoni votimin.
`processing`	Shkarkimi, ripërzierja ose bashkimi.	Shfaq përparimin e serverit.
`ready`	Shkarkimi i nënshkruar është në dispozicion.	Dërgoni URL-në për përdoruesin.
`failed`	Gabim i strukturuar i terminalit.	Lexo `error_code`. Riprovoni vetëm kur këshilloheni.
`expired`	Dalja e përkohshme u hoq.	Krijoni një punë të re.

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

QuickDL paraqet tre pika praktike për sondazhin e Punës. E para është pritja fillestare një sekondë. Mjeti kompakt më pas mbulon rikthimin e kufizuar. Pika e tij përfundimtare është dorëzimi i nënshkruar i përkohshëm.

Gabimet e parashikueshme

QuickDL afrimi Gabim kontratë përmes një zarfi jo-2xx, pastaj një ID kërkesë për mbështetje. Utiliteti kompakt mban trajtimin e parashikueshëm të klientit të qartë.

{
  "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	Kuptimi tipik	Veprim
400	URL e pavlefshme, trup ose format i papërdorshëm.	Korrigjo kërkesën. Zgjidh përsëri për formatet.
401	Mungon, i pavlefshëm, i skaduar ose me hapësirë të gabuar kyçi.	Kontrolloni kredencialet e anës së serverit.
403	Qiramarrësi ose politika e burimit refuzoi kërkesën.	Mos anashkaloni politikën. Kontaktoni mbështetjen.
404	Punë e panjohur ose e skaduar.	Krijoni një punë të re nëse është e përshtatshme.
429	Arrihet kufiri i kërkesave ose i punëve aktive.	Nderi `retry_after_seconds`.
503	Radhë/kapaciteti ose upstream përkohësisht jo i disponueshëm.	Riprovoni me prapambetje eksponenciale dhe jitter.

Kontrata operative

QuickDL jep një kuotë kompakte, specifike për klientin që mbështet integrimin pa destabilizuar shërbimet burimore.

Përdorni logjikën e aplikimit idempotent dhe kurrë mos filloni punë të dyfishta për të njëjtin klikim të përdoruesit.
Cache zgjidh metadata shkurt, por gjithmonë trajtoni URL-të e nënshkruara të shkarkimit si të skaduara.
Përdorni prapavijëzim eksponencial të kufizuar me jitter për 429, 503 dhe gabimet e riprovueshme.
Përpuno vetëm media publike ose media që jeni të autorizuar të aksesoni. DRM dhe kontrollet e aksesit nuk anashkalohen.
Mbani ID-të e kërkesave dhe ID-të e punëve në regjistrat e operacioneve private. Mos regjistroni URL-të e dërguara pa nevojë.

Në QuickDL, aktivizimi para eksplorimit vjen i pari kur shpjegohet qasja në Skemë. Ai mjet kompakt vazhdon me autentifikim të caktuar dhe përfundon me forma kërkesash të dokumentuara.

AKSESI I RISHIKUAR NGA OPERATORI

Aktivizoni përmes mbështetjes

Siguroni QuickDL me emrin e integrimit, vëllimin e pritshëm mujor dhe burimet e kërkuara. Identifikoni operacionet që serveri do të kryejë në mënyrë që miratimi të prodhojë një çelës të kufizuar, një herë.

Kërkojë aktivizimin Çelësat janë të shtrirë në qira, të revokueshme dhe të lëshuara përmes formularit të Kontaktit. Skriptet anonime nuk mund të ekzekutojnë punën e shkarkuesit.