Vetëm parashikim — kërkohet aktivizimi

Ndërto shkarkimet me downf.io

DownF mban ekzekutimin e API të çaktivizuar deri sa një operator të shqyrtojë rastin e përdorimit të përputhshmërisë. Shembujt përshkruajnë kontratën e planifikuar, ndërsa kredencialet dhe kuotat reale vijnë vetëm përmes aktivizimit të mbështetjes.

DownfBridgeJSON mbi HTTPSPunë asinkroneKredenciale me shtrirje

Fillimi i shpejtë

DownF organizon hostin e API-së rreth kredencialeve të aktivizuara nga mbështetja. Pamja e saj e kompatibilitetit krahason një pikë përfundimtare të caktuar të qiramarrësit. Një rrugë thirrjeje vetëm për server mbetet kontrolli përfundimtar.

URL e llogaritësithttps://downf.io

AutentifikimiX-API-Key: pending_activation_…

Profili i klientitDownfBridge

Versioni i APIv1

# Available only after support activation
export DOWNF_ACCESS_TOKEN="issued-after-review"

curl -X POST https://downf.io/v1/resolve \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Siguria e kredencialeve fillon me ruajtjen sekrete të serverit në DownF. Kjo pamje e pajtueshmërisë pastaj paraqet asnjë inkorporim të bundle të klientit. Fakti përfundimtar nuk ka regjistra ose depot publike.

Zgjidh një lidhje

DownF organizon operacionin Resolve rreth zbulimit të burimit. Pamja e tij e përputhshmërisë krahason format nga një URL e dorëzuar. Asnjë dalje e shpikur nuk mbetet kontrolli përfundimtar.

POST/v1/resolveFusha e veprimit: zgjidh

Fusha	Lloji	I domosdoshëm	Përshkrimi
`media_address`	URL HTTPS	Po	Faqe publike ose e autorizuar e mediave për të analizuar.
`tenant`	varg	Jo.	Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë.

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

Identifikuesi i formatit fillon me vlerën e kthyer pa ndryshuar në DownF. Kjo pamje e kompatibilitetit më pas paraqet disponueshmërinë për çdo lidhje. Fakti përfundimtar është se nuk ka etiketë cilësie të supozuar.

Krijoni dhe ndiqni një punë shkarkimi

Krijimi i punës fillon me përgatitje asinkrone në DownF. Pamja tjetër mbulon një kërkesë të shkurtër HTTP. Faqja mban të dukshme ekzekutimin e punëtorëve të kufizuar.

POST/v1/jobsFusha e veprimit: punët

Fusha	Lloji	I domosdoshëm	Përshkrimi
`media_address`	URL HTTPS	Po	I njëjti burim i normalizuar i paraqitur për të zgjidhur.
`output_ref`	varg	Po	Një ID e saktë nga përgjigja e zgjidhjes.
`tenant`	varg	Jo.	Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë.

curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'

1202 PranuarRuaj transfer_ref.

2Gjendja e sondazhitGET /v1/jobs/{transfer_ref} me të njëjtin çelës.

3GatiHapni URL-në e nënshkruar të shkarkimit.

Gjendja	Kuptimi	Veprimi i klientit
`queued`	pranohet në radhën e kufizuar.	Sondazh përsëri me prapambetje.
`extracting`	Rifreskim i metatë dhënave të burimit ose rrugës.	Vazhdoni votimin.
`processing`	Shkarkimi, ripërzierja ose bashkimi.	Shfaq përparimin e serverit.
`ready`	Shkarkimi i nënshkruar është në dispozicion.	Dërgoni URL-në për përdoruesin.
`failed`	Gabim i strukturuar i terminalit.	Lexo `error_code`. Riprovoni vetëm kur këshilloheni.
`expired`	Dalja e përkohshme u hoq.	Krijoni një punë të re.

curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

Pamja e pajtueshmërisë së DownF shqyrton pritjen fillestare prej një sekonde për sondazhin e Punës. Ajo tregon kthimin e kufizuar më pas dhe nuk errëson dorëzimin e nënshkruar përkohësisht.

Gabimet e parashikueshme

DownF paraqet tre pika praktike për kontratën e Gabimit. Së pari vjen një envelope jo-2xx. Pamja e përputhshmërisë më pas përfshin një ID kërkese për mbështetje. Pika e fundit është trajtimi i parashikueshëm i klientit.

{
  "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	Kuptimi tipik	Veprim
400	URL e pavlefshme, trup ose format i papërdorshëm.	Korrigjo kërkesën. Zgjidh përsëri për formatet.
401	Mungon, i pavlefshëm, i skaduar ose me hapësirë të gabuar kyçi.	Kontrolloni kredencialet e anës së serverit.
403	Qiramarrësi ose politika e burimit refuzoi kërkesën.	Mos anashkaloni politikën. Kontaktoni mbështetjen.
404	Punë e panjohur ose e skaduar.	Krijoni një punë të re nëse është e përshtatshme.
429	Arrihet kufiri i kërkesave ose i punëve aktive.	Nderi `retry_after_seconds`.
503	Radhë/kapaciteti ose upstream përkohësisht jo i disponueshëm.	Riprovoni me prapambetje eksponenciale dhe jitter.

Kontrata operative

DownF cakton një kufi kërkese pas shqyrtimit të klientit të synuar, duke mbajtur të qëndrueshme kontrollet e përputhshmërisë dhe ofruesit e sipërm.

Përdorni logjikën e aplikimit idempotent dhe kurrë mos filloni punë të dyfishta për të njëjtin klikim të përdoruesit.
Cache zgjidh metadata shkurt, por gjithmonë trajtoni URL-të e nënshkruara të shkarkimit si të skaduara.
Përdorni prapavijëzim eksponencial të kufizuar me jitter për 429, 503 dhe gabimet e riprovueshme.
Përpuno vetëm media publike ose media që jeni të autorizuar të aksesoni. DRM dhe kontrollet e aksesit nuk anashkalohen.
Mbani ID-të e kërkesave dhe ID-të e punëve në regjistrat e operacioneve private. Mos regjistroni URL-të e dërguara pa nevojë.

DownF organizon aksesin në Skemë rreth aktivizimit para eksplorimit. Pamja e tij e përputhshmërisë krahason autentikimin e caktuar. Format e kërkesave të dokumentuara mbeten kontrolli përfundimtar.

AKSESI I RISHIKUAR NGA OPERATORI

Aktivizoni përmes mbështetjes

Përshkruaj produktin, parashiko thirrjet mujore dhe listoi platformat që duhet të analizojë. Mbështetja e DownF do të konfirmojë fushat e nevojshme para se të lëshojë një kredencial të dukshëm një herë, kopja e ruajtur e të cilit është vetëm një hash.

Kërkojë aktivizimin Çelësat janë të kufizuar për qiramarrës, të revokueshëm dhe lëshohen përmes formularit të Kontaktit. Skriptet anonime nuk mund të kryejnë punë shkarkimi.