Csak előzetes verzió – aktiválás szükséges

Build letöltések a QuickDL segítségével

A QuickDL lehetővé teszi a fejlesztők számára, hogy megvizsgálják a kompakt kérés modellt az aktiválás előtt. A támogatásnak érvényesítenie kell a terméket, mielőtt a privát kulcs és a kvóta használhatóvá válik.

QuickDlJobsJSON HTTPS-en keresztülAszinkron feladatokHatókörrel rendelkező hitelesítő adatok

Gyors kezdés

A QuickDL-ben a támogatással aktivált hitelesítő adatok kerülnek először ismertetésre az API hoszt magyarázatakor. Ez a kompakt segédprogram egy hozzárendelt bérlői végponttal folytatódik, és egy kizárólag szerveroldali hívási úttal zárul.

Bérlő URL-jehttps://quickdl.app

HitelesítésX-API-Key: pending_activation_…

Az ügyfél profiljaQuickDlJobs

Az API verziójav1

# 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"}'

A QuickDL a hitelesítő adatok biztonságát úgy kezeli, hogy először azonosítja a szerveroldali titkos tárolást. Ezután nem ágyaz be klienscsomagot, és nem tart nyilván nyilvános naplókat vagy tárolókat.

Hivatkozás feloldása

A QuickDL-ben a forrásfelismerés az első lépés a Resolve művelet magyarázatakor. Ez a kompakt segédprogram egy benyújtott URL formátumaival folytatódik, és nem hoz létre kitalált kimeneteket.

POST/v1/resolveHatály: megoldani

Mező	Típus	Kötelező	Leírás
`public_link`	HTTPS URL	Igen.	Nyilvános vagy engedélyezett médiaoldal elemzése.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

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

A QuickDL a Formátumazonosítót úgy kezeli, hogy először változatlanul azonosítja a visszakapott értéket. Ezt követi a linkenkénti elérhetőség, és nem tart meg találgatott minőségi címkét a nézetben.

Letöltési feladat létrehozása és követése

A QuickDL kompakt segédprogram aszinkron előkészítést vizsgál a Feladat létrehozásához. Egy rövid HTTP-kérést mutat be, és nem takarja el a kötött munkavégzést.

POST/v1/jobsHatály: munkahelyek

Mező	Típus	Kötelező	Leírás
`public_link`	HTTPS URL	Igen.	Ugyanaz a normalizált forrás került benyújtásra megoldásra.
`download_option`	karakterlánc	Igen.	Egy pontos azonosító a feloldási válaszból.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

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 ElfogadvaMentés quick_job.

2A szavazás állapotaGET /v1/jobs/{quick_job} ugyanazzal a kulccsal.

3KészNyissa meg az aláírt letöltési URL-t.

Állapot	Jelentése	Ügyfél akció
`queued`	Felvétel a korlátozott várólistára.	Újra szavazás hátraléptetéssel.
`extracting`	Forrás metaadatok vagy útvonal frissítése.	Folytasd a szavazás.
`processing`	Letöltés, remuxing vagy egyesítés.	Kiszolgáló előrehaladásának megjelenítése.
`ready`	Aláírt letöltés elérhető.	Küldje el az URL-t a felhasználónak.
`failed`	Terminál strukturált hiba.	Olvasd el `error_code`Csak akkor próbálkozzon újra, ha azt tanácsolják.
`expired`	Az ideiglenes kimenetet eltávolították.	Hozzon létre egy új feladatot.

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

A QuickDL három gyakorlati pontot mutat be az állásfelméréshez. Először egy másodperces kezdeti várakozás következik. Az kompakt segédprogram ezután lefedi a korlátozott visszalépést. Az utolsó pontja az ideiglenes aláírt kézbesítés.

Kiszámítható hibák

A QuickDL a Hibaszerződést kezeli egy nem 2xx borítékon keresztül, majd egy támogatási kérelem azonosítóján. A kompakt segédprogram kiszámítható klienskezelést tart fenn egyértelműen.

{
  "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	Tipikus jelentése	Akció
400	Érvénytelen URL, tartalom vagy nem elérhető formátum.	Javítsa a kérést. Oldja meg újra a formátumokért.
401	Hiányzó, érvénytelen, lejárt vagy rossz hatókörű kulcs.	Ellenőrizze a kiszolgálóoldali hitelesítő adatokat.
403	A bérlő vagy a forrás irányelve elutasította a kérést.	Ne kerülje meg a szabályzatot. Lépjen kapcsolatba a támogatással.
404	Ismeretlen vagy lejárt munka.	Ha szükséges, hozzon létre egy új feladatot.
429	Kérés vagy aktív feladat limit elérve.	Becsület `retry_after_seconds`.
503	Sor/kapacitás vagy upstream ideiglenesen nem elérhető.	Próbálja újra exponenciális visszalépéssel és jitterrel.

Üzemeltetési szerződés

A QuickDL egy kompakt, ügyfél-specifikus kvótát biztosít, amely támogatja az integrációt anélkül, hogy destabilizálná a forrás szolgáltatásokat.

Használjon idempotens alkalmazáslogikát, és soha ne indítson párhuzamos feladatokat ugyanahhoz a felhasználói kattintáshoz.
A gyorsítótár oldja meg a metaadatokat röviden, de a aláírt letöltési URL-eket mindig lejártnak tekintse.
Használjon korlátozott exponenciális visszalépést jitterrel 429, 503 és újrapróbálható hibák.
Csak nyilvános vagy olyan médiafájlokat dolgozzon fel, amelyekhez Ön jogosult hozzáférni, és ne kerülje meg a DRM-et és a hozzáférés-vezérlést.
Tartsa meg a kérésazonosítókat és a feladatazonosítókat a privát működési naplókban. Ne naplózza szükségtelenül a beküldött URL-eket.

A QuickDL-ben az aktiválás az exploráció előtt áll, amikor a Sémához való hozzáférést magyarázzuk. Ez a kompakt segédprogram hozzárendelt hitelesítéssel folytatódik, és dokumentált kérésformákkal zárul.

ÜZEMELTETŐ ÁLTAL ELLENŐRZÖTT HOZZÁFÉRÉS

Aktiválás a támogatáson keresztül

Adja meg a QuickDL számára az integráció nevét, a várható havi mennyiséget és a szükséges forrásokat. Azonosítsa a szerver által végrehajtandó műveleteket, hogy a jóváhagyás egy szűk körű, egyszeri kulcsot eredményezzen.

Aktiválás kérése A kulcsok bérlői hatókörűek, visszavonhatók, és a Kapcsolatfelvételi űrlapon keresztül adhatóak ki. Névtelen parancsfájlok nem tudnak letöltő munkát végrehajtani.