Tik peržiūra – reikia aktyvinti

Kurti atsisiuntimus su downf.io

DownF išlaiko API vykdymą išjungtą, kol operatorius peržiūri suderinamumo naudojimo atvejį. Pavyzdžiai aprašo planuotą sutartį, o tikri prisijungimo duomenys ir kvotos gaunami tik per palaikymo aktyvavimą.

DownfBridgeJSON per HTTPSAsinchroniniai darbaiApimties kredencialai

Greita pradžia

DownF organizuoja API prieglobą remdamasis palaikymo aktyvuotais kredencialais. Jo suderinamumo rodinys lygina priskirtą nuomininko galinį tašką. Serverio tik skambučio kelias lieka galutiniu patikrinimu.

Nuomotojo URLhttps://downf.io

Autentiškumo patvirtinimasX-API-Key: pending_activation_…

Kliento profilisDownfBridge

API versijav1

# 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"}'

Sertifikato saugumas prasideda nuo serverio pusės slapto saugojimo DownF. Šis suderinamumo vaizdas tada nerodo jokio kliento paketo įterpimo. Galutinis faktas – nėra viešų žurnalų ar saugyklų.

Nuorodos išsprendimas

DownF organizuoja Resolve operaciją aplink šaltinio aptikimą. Jo suderinamumo rodinys lygina formatus iš vieno pateikto URL. Neišrasti rezultatai lieka galutiniu patikrinimu.

POST/v1/resolveTaikymo sritis: išspręsti

Laukas	Tipas	Būtinas	Aprašymas
`media_address`	HTTPS URL	Taip	Viešas arba įgaliotas žiniasklaidos puslapis analizuoti.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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

Formato identifikatorius prasideda nuo nepakitusios grąžintos reikšmės DownF. Šis suderinamumo rodinys tada pateikia prieinamumą pagal nuorodą. Galutinis faktas – nėra spėliojamos kokybės žymos.

Atsisiuntimo užduoties kūrimas ir sekimas

Darbo kūrimas DownF prasideda asinchroniniu paruošimu. Kitas vaizdas apima trumpą HTTP užklausą. Puslapis rodo riboto darbininko vykdymą.

POST/v1/jobsTaikymo sritis: darbo vietos

Laukas	Tipas	Būtinas	Aprašymas
`media_address`	HTTPS URL	Taip	Tas pats normalizuotas šaltinis pateiktas išspręsti.
`output_ref`	eilutė	Taip	Tikslus ID iš atsakymo į sprendimą.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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 PriimtaIšsaugoti transfer_ref.

2Apklausos būsenaGET /v1/jobs/{transfer_ref} tuo pačiu raktu.

3ParuoštaAtidarykite pasirašytą atsisiuntimo URL.

Būsena	Reikšmė	Kliento veiksmas
`queued`	Priimtas į ribotą eilę.	Apklausa vėl su atgal.
`extracting`	Atnaujinami šaltinio metaduomenys arba maršrutas.	Tęskite apklausą.
`processing`	Parsisiuntimas, remiksas ar sujungimas.	Rodyti serverio pažangą.
`ready`	Pasirašytas atsisiuntimas yra prieinamas.	Siųsti URL vartotojui.
`failed`	Terminalo struktūrinė klaida.	Skaityti `error_code`Bandykite dar kartą tik tada, kai patartina.
`expired`	Laikinas išėjimas buvo pašalintas.	Sukurkite naują darbą.

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

DownF suderinamumo rodinys peržiūri vienos sekundės pradinį laukimą darbo tikrinimui. Jis rodo apribotą atidėjimą ir neužstoja laikinai pasirašytos pristatymo.

Numatomos klaidos

DownF pateikia tris praktinius punktus dėl Klaidos sutarties. Pirmas yra vienas ne 2xx laiškas. Suderinamumo vaizdas tada apima palaikymo užklausos ID. Paskutinis punktas yra nuspėjamas kliento tvarkymas.

{
  "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	Tipiška reikšmė	Veiksmas
400	Netinkamas URL, tekstas arba negalimas formatas.	Ištaisykite užklausą. Išspręskite dar kartą formatams.
401	Trūksta, negalioja, pasibaigė galiojimo laikas arba neteisingos apimties raktas.	Patikrinkite serverio pusės kredencialus.
403	Nuomininkas arba šaltinio strategija atmetė užklausą.	Neaplenkite politikos. Susisiekite su palaikymo tarnyba.
404	Nežinomas arba pasibaigęs darbas.	Jei reikia, sukurkite naują darbą.
429	Pasiektas užklausos arba aktyvių užduočių limitas.	Garbė `retry_after_seconds`.
503	Eilė / talpa arba priešsroviui laikinai neprieinama.	Bandykite dar kartą su eksponentiniu atgal ir drebėjimu.

Veiklos sutartis

DownF nustato užklausos ribą peržiūrėjęs numatytą klientą, išlaikydamas suderinamumo patikrinimus ir aukštesnio lygio tiekėjus stabiliais.

Naudokite idempotentinę programos logiką ir niekada nepradėkite pasikartojančių užduočių tam pačiam vartotojo paspaudimui.
Talpykloje trumpai išsprendžiami metaduomenys, tačiau visada pasirašyti atsisiuntimo URL laikomi pasibaigusiais.
Naudokite ribotą eksponentinį atgalinį atmetimą su drebėjimu, kad 429, 503 ir pakartotinai bandomos klaidos.
Apdorokite tik viešąją laikmeną arba laikmeną, prie kurios turite prieigą. DRM ir prieigos kontrolės priemonės nebus apeitos.
Saugokite užklausų ID ir užduočių ID privačiuose veiklos žurnaluose. Nereikia registruoti pateiktų URL be reikalo.

DownF organizuoja Schema prieigą aplink aktyvavimą prieš tyrinėjimą. Jos suderinamumo rodinys lygina priskirtą autentifikaciją. Dokumentuoti užklausų formatai lieka galutiniu patikrinimu.

EKSPLOATUOTOJO PERŽIŪRIMAS

Aktyvinkite per palaikymą

Aprašykite produktą, prognozuokite jo mėnesinius skambučius ir išvardykite platformas, kurias jis turi analizuoti. DownF palaikymas patvirtins reikiamus aprėpties lygius prieš išduodant vienkartinį matomą kredencialą, kurio saugoma kopija yra tik maišos vertė.

Prašykite aktyvavimo Raktai yra nuomininko apimties, atšaukiami ir išduodami per Susisiekite formą. Anoniminiai scenarijai negali vykdyti atsisiuntimo programos darbo.