https://quickdl.appConstruiți descărcări cu QuickDL
QuickDL permite dezvoltatorilor să inspecteze modelul de solicitare compact înainte de activare. Suportul trebuie să valideze produsul înainte ca o cheie privată și o cotă să devină utilizabile.
QuickDlJobsJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu
01
Start rapid
În QuickDL, acreditările activate de suport vin primele atunci când se explică gazda API. Acea utilitate compactă este urmată de un endpoint de tenant atribuit și se încheie cu o cale de apel doar pentru server.
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 gestionează siguranța credențialelor identificând mai întâi stocarea secretelor pe partea de server. Continuă cu lipsa încorporării în pachetul client și nu păstrează în vedere niciun jurnal sau depozit public.
02
Rezolvarea unui link
În QuickDL, detectarea sursei vine prima atunci când se explică operațiunea Resolve. Această utilitate compactă este urmată de formate dintr-un singur URL trimis și se încheie fără ieșiri inventate.
POST
/v1/resolveScop: rezolva| Câmp | Tip | Obligatoriu | Descrierea |
|---|---|---|---|
public_link | URL HTTPS | Da. | Pagina media publică sau autorizată pentru a analiza. |
tenant | șir | Nu. | Domeniul entității găzduite atribuite. De obicei omis. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickDL gestionează identificatorul formatului identificând mai întâi valoarea returnată neschimbată. Continuă cu disponibilitatea pentru fiecare link și nu păstrează în vedere nicio etichetă de calitate presupusă.
03
Crearea și urmărirea unei lucrări de descărcare
Utilitatea compactă a QuickDL revizuiește pregătirea asincronă pentru crearea de locuri de muncă. Arată o scurtă solicitare HTTP în continuare și nu ascunde execuția lucrătorilor limitați.
POST
/v1/jobsDomeniul de aplicare: locuri de muncă| Câmp | Tip | Obligatoriu | Descrierea |
|---|---|---|---|
public_link | URL HTTPS | Da. | Aceeași sursă normalizată prezentată pentru a rezolva. |
download_option | șir | Da. | Un ID exact din răspunsul de rezolvare. |
tenant | șir | Nu. | Domeniul entității găzduite atribuite. De obicei omis. |
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} cu aceeași cheie.| Starea | Semnificație | Acțiune de client |
|---|---|---|
queued | Admis în coada limitată. | Sondaj din nou cu backoff. |
extracting | Reîmprospătarea metadatelor sursă sau a rutei. | Continuă să votezi. |
processing | Descărcarea, remixarea sau îmbinarea. | Afișați progresul serverului. |
ready | Descărcarea semnată este disponibilă. | Trimiteți URL-ul utilizatorului. |
failed | Eroare structurată terminală. | Citiți error_code. Reîncercaţi numai atunci când este recomandat. |
expired | Ieșirea temporară a fost eliminată. | Creați un loc de muncă nou. |
curl https://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDL prezintă trei puncte practice pentru interogarea Job. Primul este așteptarea inițială de o secundă. Utilitarul compact acoperă apoi exponențializarea limitată. Ultimul său punct este livrarea temporară semnată.
04
Erori previzibile
QuickDL abordează contractul de eroare printr-un plic non-2xx, apoi un ID de solicitare de asistență Utilitarul compact păstrează manipularea previzibilă a clientului explicit.
{
"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 | Semnificație tipică | Acțiune |
|---|---|---|
| 400 | URL nevalid, corp sau format indisponibil. | Corectați solicitarea. Rezolvați din nou pentru formate. |
| 401 | Cheie lipsă, nevalidă, expirată sau cu domeniu incorect. | Verificați acreditările de pe partea serverului. |
| 403 | Politica chiriașului sau a sursei a respins solicitarea. | Nu ocoliți politica. Contactați asistența. |
| 404 | Loc de muncă necunoscut sau expirat. | Creați un nou loc de muncă, dacă este cazul. |
| 429 | A fost atinsă limita de solicitări sau de lucrări active. | Onoare. retry_after_seconds. |
| 503 | Coada/capacitatea sau sursa din amonte sunt temporar indisponibile. | Reîncercați cu backoff exponențial și jitter. |
05
Contract de exploatare
QuickDL acordă o cotă compactă, specifică clientului, care acceptă integrarea fără a destabiliza serviciile sursă.
- Folosiți logică de aplicație idempotentă și nu porniți niciodată joburi duplicate pentru același clic al utilizatorului.
- Stocați temporar metadatele rezolvate în cache, dar tratați întotdeauna URL-urile semnate de descărcare ca expirabile.
- Utilizați backoff exponențial limitat cu jitter pentru
429,503şi erori reîncercabile. - Procesează doar media publică sau media la care ești autorizat să ai acces. DRM și controalele de acces nu sunt ocolite.
- Păstrați ID-urile cererilor și ID-urile joburilor în jurnalele operaționale private. Nu înregistrați inutil URL-urile trimise.
În QuickDL, activarea înaintea explorării vine prima atunci când se explică accesul la Schema. Acea utilitate compactă este urmată de autentificarea atribuită și se încheie cu formele de solicitare documentate.
Activați prin asistență
Furnizați QuickDL cu numele integrării, volumul lunar estimat și sursele necesare. Identificați operațiunile pe care le va efectua serverul, astfel încât aprobarea să genereze o cheie unică, limitată strict la scopul cerut.
Solicitați activarea Cheile sunt limitate la nivel de chiriaș, pot fi revocate și sunt emise prin formularul de contact. Scripturile anonime nu pot executa sarcini de descărcare.