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

Veidojiet lejupielādes ar downf.io

DownF saglabā API izpildi atslēgtu, līdz operators pārskata saderības lietošanas gadījumu. Piemēri apraksta plānoto līgumu, kamēr reālas akreditācijas un kvotas tiek saņemtas tikai caur atbalsta aktivizāciju.

DownfBridgeJSON, izmantojot HTTPSAsinhronie darbiAptvertie akreditācijas dati

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

DownF organizē API resursdatoru ap atbalstu aktivizētām akreditācijām. Tā saderības skats salīdzina piešķirto nomnieka galapunktu. Servera tikai zvana ceļš paliek galīgā pārbaude.

Nomnieka URLhttps://downf.io

AutentifikācijaX-API-Key: pending_activation_…

Klienta profilsDownfBridge

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

Apliecību drošība sākas ar servera puses slepeno glabāšanu DownF. Šis saderības skats pēc tam neietver klienta pakotnes iegulšanu. Gala fakts ir, ka nav publisku žurnālu vai krātuvju.

Saites atrisināšana

DownF organizē Resolve darbību ap avotu noteikšanu. Tās saderības skats salīdzina formātus no viena iesniegtā URL. Nav izgudroti izvadi paliek galīgā pārbaude.

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

Lauks	Tips	Nepieciešams	Apraksts
`media_address`	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
}

Formāta identifikators sākas ar atgriezto vērtību nemainītu DownF. Šis saderības skats pēc tam parāda pieejamību pa saitēm. Galīgais fakts ir, ka nav uzminētas kvalitātes etiķetes.

Izveidot un sekot lejupielādes uzdevumam

Darba izveide sākas ar asinhronu sagatavošanu DownF. Nākamais skats aptver īsu HTTP pieprasījumu. Lapa saglabā ierobežotas darbinieka izpildes redzamību.

PAST/v1/jobsDarbības joma: darba vietas

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

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

2Aptaujas statussGET /v1/jobs/{transfer_ref} 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://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

DownF saderības skats pārskata vienas sekundes sākotnējo gaidīšanu darba aptaujai. Tas rāda ierobežotu atkāpšanās laiku un nepārklāj pagaidu parakstītas piegādes.

Paredzamās kļūdas

DownF piedāvā trīs praktiskus punktus kļūdas līgumam. Pirmais ir viens ne-2xx aploksne. Saderības skats pēc tam aptver atbalsta pieprasījuma ID. Tā pēdējais punkts ir paredzama klienta apstrāde.

{
  "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

DownF piešķir pieprasījuma griestus pēc paredzētā klienta pārskatīšanas, saglabājot tā saderības pārbaudes un augšupvadošos pakalpojumu sniedzējus stabilus.

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.

DownF organizē shēmas piekļuvi ap aktivizāciju pirms izpētes. Tās saderības skats salīdzina piešķirto autentifikāciju. Dokumentētie pieprasījuma veidi paliek galvenā pārbaude.

EKSPLUATANTA PĀRBAUDĪTA PIEKĻUVE

Aktivizēšana, izmantojot atbalstu

Aprakstiet produktu, prognozējiet tā mēneša zvanu skaitu un uzskaitiet platformas, kuras tam jāanalizē. DownF atbalsts apstiprinās nepieciešamos apjomus pirms izsniegs vienreizēju redzamu akreditāciju, kuras saglabātā kopija ir tikai hašs.

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.