Tikai priekšskatījums — nepieciešama aktivizācija

Lejupielādes veidošana ar QuickDL

QuickDL ļauj izstrādātājiem pārbaudīt kompakto pieprasījuma modeli pirms aktivizācijas. Atbalstam jāapstiprina produkts pirms privātā atslēga un kvota kļūst izmantojama.

QuickDlJobsJSON, izmantojot HTTPSAsinhronie darbiAptvertie akreditācijas dati

Ātrās sākšanas rokasgrāmata

QuickDL gadījumā, atbalsta aktivizētās akreditācijas tiek minētas pirmās, skaidrojot API saimnieku. Šis kompaktais rīks seko ar piešķirtu nomnieka galapunktu un noslēdzas ar tikai servera zvanu ceļu.

Nomnieka URLhttps://quickdl.app

AutentifikācijaX-API-Key: pending_activation_…

Klienta profilsQuickDlJobs

API versijav1

# 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 risina akreditācijas drošību, vispirms identificējot servera puses slepeno glabāšanu. Tā turpina bez klienta pakotnes iegulšanas un nesaglabā publiskos žurnālus vai repozitorijus redzamībā.

Saites atrisināšana

QuickDL avota noteikšana ir pirmajā vietā, skaidrojot Resolve darbību. Šī kompakta utilītāte seko ar formātiem no viena iesniegtā URL un beidzas bez izgudrotiem izvadiem.

PAST/v1/resolveDarbības joma: atrisināt

Lauks	Tips	Nepieciešams	Apraksts
`public_link`	HTTPS URL	Jā	Publiska vai pilnvarota mediju lapa analīzei.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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

QuickDL apstrādā formāta identifikatoru, vispirms identificējot atgriezto vērtību nemainītu. Tas seko ar katras saites pieejamību un neuztur redzeslokā nevienu uzminētu kvalitātes etiķeti.

Izveidot un sekot lejupielādes uzdevumam

QuickDL kompaktais rīks pārskata asinhrono sagatavošanos Darba izveidei. Tas parāda īsu HTTP pieprasījumu nākamajā solī un neslēpj saistīto darbinieku izpildi.

PAST/v1/jobsDarbības joma: darba vietas

Lauks	Tips	Nepieciešams	Apraksts
`public_link`	HTTPS URL	Jā	Tika iesniegts tas pats normalizētais avots, lai atrisinātu.
`download_option`	virkne	Jā	Precīzs ID no atrisināšanas atbildes.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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 PieņemtsSaglabāt quick_job.

2Aptaujas statussGET /v1/jobs/{quick_job} ar to pašu atslēgu.

3GatavsAtvērt parakstīto lejupielādes URL.

Statuss	Nozīme	Klienta darbība
`queued`	Iesniegts ierobežotajā rindā.	Aptauja vēlreiz ar atkāpšanos.
`extracting`	Avota metadatu vai maršruta atsvaidzināšana.	Turpiniet aptauju.
`processing`	Lejupielāde, pārkodēšana vai apvienošana.	Parādīt servera progresu.
`ready`	Parakstīta lejupielāde ir pieejama.	Nosūtiet vietrādi URL lietotājam.
`failed`	Termināla strukturēta kļūda.	Lasīt `error_code`Atkārtojiet mēģinājumu tikai tad, kad ieteicams.
`expired`	Pagaidu izvade tika noņemta.	Izveidojiet jaunu darbu.

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

QuickDL piedāvā trīs praktiskus punktus darba aptaujai. Pirmais ir viena sekunde sākotnējai gaidīšanai. Kompaktais rīks pēc tam aptver ierobežotu atkāpšanos. Tā pēdējais punkts ir pagaidu parakstīta piegāde.

Paredzamās kļūdas

QuickDL pieiet kļūdu līgumam caur vienu ne-2xx aploksni, pēc tam atbalsta pieprasījuma ID. Kompaktais rīks saglabā paredzamu klienta apstrādi skaidri.

{
  "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	Tipiska nozīme	Darbība
400	Nederīgs URL, pamatteksts vai nepieejams formāts.	Labojiet pieprasījumu. Mēģiniet vēlreiz formātiem.
401	Trūkst, nederīgs, beidzies vai nepareiza darbības joma atslēga.	Pārbaudīt servera puses akreditācijas datus.
403	Nomnieka vai avota politika noraidīja pieprasījumu.	Nepārkāpiet politiku. Sazinieties ar atbalstu.
404	Nezināms vai beidzies darba laiks.	Ja nepieciešams, izveidojiet jaunu uzdevumu.
429	Sasniegts pieprasījumu vai aktīvo darbu ierobežojums.	Gods `retry_after_seconds`.
503	Rinda/kapacitāte vai augšupejošais savienojums pagaidām nav pieejams.	Atkārtoti mēģiniet ar eksponenciālu atpakaļejošu aizkavi un traucējumiem.

Darbības līgums

QuickDL piešķir kompaktu, klientam specifisku kvotu, kas atbalsta integrāciju, neizjaucot avota pakalpojumus.

Izmantojiet idempotent lietojumprogrammu loģiku un nekad nesāciet dublēt darbus vienam un tam pašam lietotāja klikšķim.
Kešatmiņa īsi atrisina metadatus, bet vienmēr uzskata, ka parakstītie lejupielādes URL ir beigušies.
Izmantojiet ierobežotu eksponenciālo atpakaļejošo aizkavi ar nejaušību 429, 503 un atkārtojamām kļūdām.
Apstrādājiet tikai publisku multividi vai multividi, kurai jums ir piekļuve. DRM un piekļuves kontroles netiek apietas.
Saglabājiet pieprasījumu ID un darba ID privātos darbības žurnālos. Nelietojiet iesniegtos URL nevajadzīgi.

QuickDL gadījumā, aktivizācija pirms izpētes tiek minēta pirmā, skaidrojot shēmas piekļuvi. Šis kompaktais rīks seko ar piešķirtu autentifikāciju un noslēdzas ar dokumentētām pieprasījuma formām.

EKSPLUATANTA PĀRBAUDĪTA PIEKĻUVE

Aktivizēšana, izmantojot atbalstu

Nodrošiniet QuickDL ar integrācijas nosaukumu, paredzamo mēneša apjomu un nepieciešamajiem avotiem. Identificējiet darbības, ko serveris veiks, lai apstiprinājums radītu šauri definētu, vienreizēju atslēgu.

Pieprasīt aktivizāciju Atslēgas ir īrnieka mērogā, atsaucamas un izsniegtas caur Kontaktformu. Anonīmi skripti nevar izpildīt lejupielādētāja darbu.