Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med QuickDL

QuickDL låter utvecklare inspektera den kompakta förfrågningsmodellen innan aktivering. Supporten måste validera produkten innan en privat nyckel och kvot blir användbara.

QuickDlJobsJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

I QuickDL kommer aktiverade uppgifter med support först när API-värden förklaras. Den kompakta verktygen följer med en tilldelad klientslutpunkt och avslutas med en server-endast-anropsväg.

Webbadress till klienthttps://quickdl.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilQuickDlJobs

API-versionv1

# 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 hanterar säkerheten för autentiseringsuppgifter genom att först identifiera serverbaserad hemlig lagring. Därefter följer ingen inbäddning i klientbundles och inga offentliga loggar eller repositories hålls i sikte.

Lösa en länk

I QuickDL kommer källidentifiering först när man förklarar Resolve-operationen. Det kompakta verktyget följer sedan upp med format från en inskickad URL och avslutas utan några påhittade utdata.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`public_link`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

QuickDL hanterar formatidentifieraren genom att först identifiera det returnerade värdet oförändrat. Därefter följer per länk-tillgänglighet och ingen gissad kvalitetsbeteckning visas.

Skapa och följ ett nedladdningsjobb

QuickDL:s kompakta verktyg granskar asynkron förberedelse för skapande av jobb. Det visar en kort HTTP-begäran härnäst och döljer inte avgränsad exekvering av arbetare.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`public_link`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`download_option`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara quick_job.

2OmröstningsstatusGET /v1/jobs/{quick_job} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

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

QuickDL presenterar tre praktiska punkter för Job-avfrågning. Först kommer en initial väntan på en sekund. Det kompakta verktyget täcker sedan begränsad backoff. Dess sista punkt är tillfällig signerad leverans.

Förutsägbara fel

QuickDL närmar sig felkontraktet genom ett icke-2xx-omslag, följt av ett supportärende-ID. Det kompakta verktyget håller förutsägbar klienthantering tydlig.

{
  "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	Typisk betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

QuickDL ger en kompakt, klientspecifik kvot som stöder integrationen utan att destabilisera källtjänsterna.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

I QuickDL kommer aktivering före utforskning först när Schema-åtkomst förklaras. Det kompakta verktyget följer därefter med tilldelad autentisering och avslutas med dokumenterade begäransformat.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Ange QuickDL med integrationsnamnet, förväntad månatlig volym och erforderliga källor. Ange vilka åtgärder servern ska utföra så att godkännandet ger en snävt avgränsad, engångsnyckel.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.