https://quickdl.appBouw downloads met QuickDL
QuickDL stelt ontwikkelaars in staat het compacte verzoekmodel te inspecteren vóór activatie. Ondersteuning moet het product valideren voordat een privésleutel en quotum bruikbaar worden.
QuickDlJobsVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik
01
Snel aan de slag
In QuickDL komen door ondersteuning geactiveerde referenties eerst bij het uitleggen van de API-host. Dat compacte hulpprogramma volgt met een toegewezen tenant-eindpunt en sluit af met een server-only oproeppad.
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 behandelt Credential-beveiliging door eerst server-side geheime opslag te identificeren. Het volgt zonder client-bundel embedding en houdt geen openbare logs of repositories in zicht.
02
Een koppeling oplossen
In QuickDL komt bronherkenning eerst bij het uitleggen van de Resolve-operatie. Die compacte tool volgt met formaten van één ingediende URL en sluit af zonder verzonnen uitvoer.
POST
/v1/resolveToepassingsgebied: oplossen| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
public_link | HTTPS-URL | Ja. | Openbare of geautoriseerde mediapagina om te analyseren. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickDL verwerkt Format identifier door eerst de geretourneerde waarde ongewijzigd te identificeren. Daarna volgt per-link beschikbaarheid en wordt er geen geraden kwaliteitslabel weergegeven.
03
Maak en volg een downloadtaak
De compacte utility van QuickDL beoordeelt asynchrone voorbereiding voor het aanmaken van een Taak. Het toont een korte HTTP-aanvraag daarna en verbergt de uitvoering van de gebonden worker niet.
POST
/v1/jobsScope: vacatures| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
public_link | HTTPS-URL | Ja. | Dezelfde genormaliseerde bron ingediend om op te lossen. |
download_option | tekenreeks | Ja. | Een exacte ID uit de resolve-respons. |
tenant | tekenreeks | Nee. | Toegewezen tenantdomein. Meestal weggelaten. |
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} met dezelfde sleutel.| Status | Betekenis | Actie van de klant |
|---|---|---|
queued | Toegestaan in de beperkte wachtrij. | Poll weer met achteruit. |
extracting | Bronmetadata of route vernieuwen. | Ga door met pollen. |
processing | Bezig met downloaden, remuxen of samenvoegen. | Toon server voortgang. |
ready | Ondertekende download is beschikbaar. | Stuur de URL naar de gebruiker. |
failed | Terminal gestructureerde fout. | Lees error_codeProbeer het alleen opnieuw als dat wordt geadviseerd. |
expired | Tijdelijke uitvoer werd verwijderd. | Maak een nieuwe taak aan. |
curl https://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDL presenteert drie praktische punten voor Job polling. Eerst komt een initiële wachttijd van één seconde. De compacte tool behandelt vervolgens begrensde backoff. Het laatste punt is tijdelijke ondertekende levering.
04
Voorspelbare fouten
QuickDL benadert Foutcontract via één niet-2xx-envelop, vervolgens een ondersteuningsaanvraag-ID. Het compacte hulpprogramma houdt voorspelbare clientafhandeling expliciet.
{
"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 | Typische betekenis | Actie |
|---|---|---|
| 400 | Ongeldige URL, body of niet beschikbare indeling. | Corrigeer de aanvraag. Los opnieuw op voor formaten. |
| 401 | Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel. | Controleer de serverzijde referentie. |
| 403 | Tenant of bronbeleid heeft de aanvraag afgewezen. | Omzeil het beleid niet. Neem contact op met de ondersteuning. |
| 404 | Onbekende of verlopen vacature. | Maak indien nodig een nieuwe taak aan. |
| 429 | Aanvraag- of actieve-taaklimiet bereikt. | Eer retry_after_seconds. |
| 503 | Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar. | Probeer het opnieuw met exponentiële backoff en jitter. |
05
Operationeel contract
QuickDL verleent een compacte, clientspecifieke quota die de integratie ondersteunt zonder bronservices te destabiliseren.
- Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
- Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
- Gebruik begrensde exponentiële backoff met jitter voor
429,503en herprobeerbare fouten. - Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
- Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.
In QuickDL komt activering vóór verkenning als eerste bij het uitleggen van Schema-toegang. Die compacte tool volgt met toegewezen authenticatie en sluit af met gedocumenteerde aanvraagvormen.
Activeren via ondersteuning
Voorzie QuickDL van de integratienaam, het verwachte maandvolume en de vereiste bronnen. Identificeer de bewerkingen die de server zal uitvoeren zodat goedkeuring een nauwkeurig afgebakende, eenmalige sleutel oplevert.
Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.