Solo anteprima — attivazione richiesta

Costruire i download con QuickDL

QuickDL consente agli sviluppatori di ispezionare il modello di richiesta compatto prima dell'attivazione. Il supporto deve convalidare il prodotto prima che una chiave privata e una quota diventino utilizzabili.

QuickDlJobsJSON su HTTPSLavori asincroniCredenziali con ambito

Quick start

In QuickDL, le credenziali attivate dal supporto vengono presentate per prime quando si spiega l'host API. Questa utility compatta prosegue con un endpoint tenant assegnato e si conclude con un percorso di chiamata solo server.

URL del tenanthttps://quickdl.app

AutenticazioneX-API-Key: pending_activation_…

Profilo del clienteQuickDlJobs

Versione dell'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 gestisce la sicurezza delle credenziali identificando prima l'archiviazione segreta lato server, quindi senza incorporamento di bundle client e senza tenere in vista registri o repository pubblici.

Risolvere un collegamento

In QuickDL, il rilevamento della fonte viene prima di tutto quando si spiega l'operazione Resolve. Questa utility compatta segue con formati da un URL inviato e si chiude su nessun output inventato.

POST/v1/resolveAmbito di applicazione: risolvere

Campo	Tipo	Obbligatorio	Descrizione
`public_link`	URL HTTPS	Sì	Pagina media pubblica o autorizzata da analizzare.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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

QuickDL gestisce l'identificatore di formato identificando prima il valore restituito invariato, quindi segue con la disponibilità per collegamento e non mantiene in vista alcuna etichetta di qualità indovinata.

Creare e seguire un processo di download

QuickDL Le recensioni compatte dell'utilità preparano in modo asincrono la creazione del lavoro. Mostra una breve richiesta HTTP successiva e non oscura l'esecuzione del worker vincolato.

POST/v1/jobsAmbito: posti di lavoro

Campo	Tipo	Obbligatorio	Descrizione
`public_link`	URL HTTPS	Sì	La stessa fonte normalizzata è stata inviata per la risoluzione.
`download_option`	stringa	Sì	Un ID esatto dalla risposta di risoluzione.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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

2Stato del sondaggioGET /v1/jobs/{quick_job} con la stessa chiave.

3ProntoAprire l'URL di download firmato.

Stato	Significato	Azione del cliente
`queued`	Ammesso alla coda limitata.	Sondaggio di nuovo con backoff.
`extracting`	Aggiornamento dei metadati di origine o della rotta.	Continua a sondare.
`processing`	Scaricare, remux o unire.	Visualizza il progresso del server.
`ready`	Il download firmato è disponibile.	Invia l'URL all'utente.
`failed`	Errore strutturato terminale.	Leggi `error_code`Riprova solo quando ti viene consigliato.
`expired`	L'uscita temporanea è stata rimossa.	Creare un nuovo lavoro.

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

QuickDL presenta tre punti pratici per il sondaggio di lavoro. Il primo è un'attesa iniziale di un secondo. L'utilità compatta copre poi il backoff limitato. Il suo punto finale è la consegna temporanea firmata.

Errori prevedibili

QuickDL si avvicina al contratto Error tramite una busta non 2xx, quindi un ID di richiesta di supporto.

{
  "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	Significato tipico	Azione
400	URL, corpo o formato non valido.	Correggi la richiesta. Risolvi di nuovo per i formati.
401	Chiave mancante, non valida, scaduta o con ambito errato.	Verificare le credenziali lato server.
403	Criterio di tenant o di origine ha rifiutato la richiesta.	Non aggirare la politica. Contattare l'assistenza.
404	Offerta di lavoro sconosciuta o scaduta.	Creare un nuovo lavoro, se del caso.
429	Richiesta o limite di lavori attivi raggiunto.	Onore `retry_after_seconds`.
503	Coda/capacità o upstream temporaneamente non disponibile.	Riprova con backoff esponenziale e jitter.

Contratto operativo

QuickDL concede una quota compatta e specifica per il client che supporta l'integrazione senza destabilizzare i servizi di origine.

Usa una logica applicativa idempotente e non avviare mai lavori duplicati per lo stesso clic dell'utente.
Memorizza brevemente i metadati di risoluzione, ma considera sempre le URL di download firmate come scadute.
Usa il backoff esponenziale limitato con jitter per 429, 503 e errori riprovabili.
Elabora solo media pubblici o media a cui sei autorizzato ad accedere. DRM e controlli di accesso non vengono bypassati.
Conserva gli ID delle richieste e gli ID dei lavori nei registri operativi privati. Non registrare inutilmente gli URL inviati.

In QuickDL, l'attivazione prima dell'esplorazione viene presentata per prima quando si spiega l'accesso allo Schema. Questa utility compatta prosegue con l'autenticazione assegnata e si conclude con forme di richiesta documentate.

ACCESSO REVISO DALL'OPERATORE

Attivazione tramite supporto

Fornisci a QuickDL il nome dell'integrazione, il volume mensile previsto e le fonti richieste. Identifica le operazioni che il server eseguirà in modo che l'approvazione produca una chiave a tempo unico e a ambito ristretto.

Richiedi attivazione Le chiavi sono limitate all'inquilino, revocabili e rilasciate tramite il modulo di contatto. Gli script anonimi non possono eseguire lavori di download.