Esikatselu vain — aktivointi vaaditaan

Rakenna lataukset QuickDL: llä

QuickDL antaa kehittäjien tarkastella tiivistä pyyntömallia ennen käyttöönottoa. Tuen on vahvistettava tuote ennen kuin yksityinen avain ja kiintiö tulevat käyttökelpoisiksi.

QuickDlJobsJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot

Pika-aloitus

QuickDL:ssa tukikäyttöön aktivoidut tunnukset mainitaan ensin, kun API-isäntää selitetään. Tätä kompaktia apuohjelmaa seuraa määritetty tenantin päätepiste, ja se päättyy palvelinpuolen kutsupolkuun.

Vuokraajan URL- osoitehttps://quickdl.app

TodentaminenX-API-Key: pending_activation_…

AsiakasprofiiliQuickDlJobs

API-versiov1

# 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 hoitaa tunnistetietojen turvallisuuden tunnistamalla ensin palvelinpuolen salaisen tallennuksen. Sen jälkeen se ei upota mitään asiakaspuolen pakettiin eikä pidä julkisia lokeja tai repositorioita näkyvissä.

Linkin ratkaiseminen

QuickDL:ssa lähteen tunnistus tulee ensin, kun selitetään Resolve-toimintoa. Tämän kompaktin apuohjelman jälkeen seuraavat yhden lähetetyn URL-osoitteen muodot, eikä se luo mitään keksittyjä tulosteita.

POSTI/v1/resolveLaajuus: ratkaista

Kenttä	Tyyppi	Pakollinen	Kuvaus
`public_link`	HTTPS- URL	- Kyllä.	Julkinen tai valtuutettu mediapohja analysoitavaksi.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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

QuickDL käsittelee Format-tunnisteen tunnistamalla ensin palautetun arvon muuttumattomana. Se seuraa linkkikohtaisen saatavuuden kanssa eikä pidä mitään arvaamatonta laatumerkintää näkyvissä.

Luo ja seuraa lataustehtävää

QuickDL: n kompakti apuohjelma tarkastelee asynkronista valmistelua työn luomiseen. Se näyttää lyhyen HTTP-pyynnön seuraavaksi eikä peitä rajattua työntekijän suorittamista.

POSTI/v1/jobsLaajuus: työpaikat

Kenttä	Tyyppi	Pakollinen	Kuvaus
`public_link`	HTTPS- URL	- Kyllä.	Sama normalisoitu lähde lähetetty ratkaistavaksi.
`download_option`	merkkijono	- Kyllä.	Tarkka tunnus ratkaisuvasteesta.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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 HyväksyttyTallenna quick_job.

2Kyselyn tilaGET /v1/jobs/{quick_job} samalla avaimella.

3Valmiina.Avaa allekirjoitettu lataus-URL.

Tila	Merkitys	Asiakastoiminta
`queued`	Pääsi rajattuun jonoon.	Kysely uudelleen takaisinvedolla.
`extracting`	Päivitetään lähdemetatietoja tai reittiä.	Jatka äänestystä.
`processing`	Ladataan, remuxataan tai yhdistetään.	Näytä palvelimen edistyminen.
`ready`	Allekirjoitettu lataus on saatavilla.	Lähetä URL-osoite käyttäjälle.
`failed`	Päätelaitteen rakenteellinen virhe.	Lue `error_code`Yritä uudelleen vain, kun sitä kehotetaan.
`expired`	Väliaikainen tuotos poistettiin.	Luo uusi työpaikka.

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

QuickDL esittelee kolme käytännön kohtaa Job-kyselylle. Ensimmäisenä on yhden sekunnin alkuodotus. Kompakti apuohjelma käsittelee sitten rajoitettua backoffia. Sen viimeinen kohta on väliaikainen allekirjoitettu toimitus.

Ennustettavat virheet

QuickDL lähestyy Virhe sopimus kautta yksi ei-2xx kirjekuori, sitten tukipyyntö ID. Kompakti apuohjelma pitää ennustettavissa asiakas käsittely eksplisiittinen.

{
  "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	Tyypillinen merkitys	Toimi
400	Virheellinen URL-osoite, sisältö tai formaatti ei ole saatavilla.	Korjaa pyyntö. Ratkaise uudelleen formaateille.
401	Puuttuva, virheellinen, vanhentunut tai väärän laajuuden avain.	Tarkista palvelinpuolen tunnistetiedot.
403	Vuokralaisen tai lähdepolitiikan pyyntö hylättiin.	Älä ohita käytäntöä. Ota yhteyttä tukeen.
404	Tuntematon tai vanhentunut työpaikka.	Luo uusi tehtävä, jos tarpeen.
429	Pyyntö- tai aktiivisten tehtävien raja saavutettu.	Kunnia. `retry_after_seconds`.
503	Jono/kapasiteetti tai ylävirta tilapäisesti poissa käytöstä.	Yritä uudelleen eksponentiaalisella viiveellä ja häiriöllä.

Toiminnan sopimus

QuickDL myöntää kompaktin, asiakaskohtaisen kiintiön, joka tukee integraatiota ilman, että lähdepalvelut epävakautuvat.

Käytä idempotenttia sovelluslogiikkaa äläkä koskaan käynnistä päällekkäisiä tehtäviä saman käyttäjän klikkauksesta.
Välimuisti ratkaisee metatiedot lyhyesti, mutta käsittelee aina allekirjoitettuja lataus-URL-osoitteita vanhenevina.
Käytä rajattua eksponentiaalista takaisinkytkentää häiriöllä varten 429, 503 ja uudelleenyritettävä virheitä.
Käsittele vain julkista mediaa tai mediaa, johon sinulla on oikeus. DRM- ja käyttöoikeusrajoituksia ei kiertää.
Pidä pyyntö- ja työn tunnukset yksityisissä toimintalokeissa. Älä kirjaa lähetettyjä URL-osoitteita tarpeettomasti.

QuickDL:ssa aktivointi ennen tutkimista tulee ensin, kun selitetään Schema-käyttöä. Tuo kompakti apuohjelma seuraa sen jälkeen määritetyllä todennuksella ja päättyy dokumentoituihin pyyntömuotoihin.

TOIMIJAN TARKASTAMALLA PÄÄSY

Aktivoi tuen kautta

Anna QuickDL:lle integraation nimi, odotettu kuukausittainen määrä ja tarvittavat lähteet. Tunnista palvelimen suorittamat toiminnot, jotta hyväksyntä tuottaa kapean käyttöalueen kertakäyttöisen avaimen.

Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.