Samo predogled – zahteva se aktivacija

Ustvari prenose z downf.io

DownF ohranja izvajanje API onemogočeno, dokler operater ne pregleda primera uporabe združljivosti. Primeri opisujejo načrtovano pogodbo, medtem ko resnične poverilnice in kvote pridejo le prek aktivacije podpore.

DownfBridgeJSON prek HTTPSAsinhroni opravkiVerifikacijske podatke z obsegom

Hitri začetek

DownF organizira gostitelja API okoli poverilnic, aktiviranih s podporo. Njegov pogled združljivosti primerja dodeljeno končno točko najemnika. Pot klicev samo na strežnik ostaja končna preverba.

URL najemnikahttps://downf.io

AvtentikacijaX-API-Key: pending_activation_…

Profil odjemalcaDownfBridge

Različica API-jav1

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

Varnost poverilnic se začne s shranjevanjem skrivnosti na strežniški strani na DownF. Ta pogled združljivosti nato ne prikazuje vdelave odjemalskega paketa. Končni podatek je, da ni javnih dnevnikov ali repozitorijev.

Reši povezavo

DownF organizira operacijo Resolve okoli zaznavanja virov. Njegov pogled združljivosti primerja formate z ene predložene URL. Noben izmišljeni izhod ne ostane kot končna preverba.

POST/v1/resolveObseg: razreši

Polje	Vrsta	Zahtevano	Opis
`media_address`	HTTPS URL	Da.	Javna ali pooblaščena medijska stran za analizo.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

Identifikator formata se začne z vrnjeno vrednostjo nespremenjeno v DownF. Ta pogled združljivosti nato prikaže razpoložljivost na povezavo. Končni podatek je, da ni domnevne oznake kakovosti.

Ustvarjanje in spremljanje opravila prenosa

Ustvarjanje opravila se začne z asinhrono pripravo na DownF. Naslednji pogled pokriva kratko HTTP zahtevo. Stran ohranja omejeno izvajanje delavca vidno.

POST/v1/jobsObseg: delovna mesta

Polje	Vrsta	Zahtevano	Opis
`media_address`	HTTPS URL	Da.	Isti normalizirani vir je bil poslan za rešitev.
`output_ref`	niz	Da.	Natančna ID iz odziva reševanja.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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 SprejetoShrani transfer_ref.

2Stanje anketeGET /v1/jobs/{transfer_ref} z istim ključem.

3PripravljenOdprite podpisan URL za prenos.

Stanje	Pomen	Dejanje stranke
`queued`	Sprejeto v omejeno čakalno vrsto.	Anketa znova z backoff.
`extracting`	Osveževanje metapodatkov vira ali poti.	Nadaljujte z glasovanjem.
`processing`	Prenos, remuxing ali združevanje.	Prikaz napredka strežnika.
`ready`	Podpisan prenos je na voljo.	Pošljite URL uporabniku.
`failed`	Napaka strukture terminala.	Preberi `error_code`Ponovite le, ko vam svetujemo.
`expired`	Začasni izhod je bil odstranjen.	Ustvarite novo delovno mesto.

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

Pogled združljivosti DownF pregleda eno sekundo začetnega čakanja na anketiranje o delu. Prikazuje omejeno nazaj naprej in ne zastira začasno podpisane dostave.

Predvidljive napake

DownF predstavlja tri praktične točke za pogodbo o napaki. Prva je ena ovojnica brez 2xx statusa. Pogled združljivosti nato zajema ID zahteve za podporo. Njegova zadnja točka je predvidljivo ravnanje s stranko.

{
  "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čen pomen	Ukrepanje
400	Neveljaven URL, telo ali nedosegljiv format.	Popravite zahtevo. Ponovno rešite za formate.
401	Manjkajoč, neveljaven, potekel ali napačnega obsega ključ.	Preverite poverilnice na strani strežnika.
403	Najemnik ali izvorna politika sta zavrnila zahtevo.	Ne zaobidite politike. Kontaktirajte podporo.
404	Neznano ali poteklo delovno mesto.	Po potrebi ustvarite novo delovno mesto.
429	Dosežena omejitev zahtev ali aktivnih opravil.	Čast. `retry_after_seconds`.
503	Čakalna vrsta/zmogljivost ali zgornji tok začasno ni na voljo.	Poskusite znova z eksponentnim zamikom in naključnim odmikom.

Pogodba o obratovanju

DownF določi zgornjo mejo zahtevka po pregledu nameravanega odjemalca, pri čemer ohranja stabilne preverjanja združljivosti in zgornje ponudnike.

Uporabite idempotentno logiko aplikacije in nikoli ne zaženite podvojenih opravil za isti klik uporabnika.
Predpomnite metapodatke reševanja na kratko, vendar vedno obravnavajte podpisane URL-je za prenos kot potekle.
Uporabite omejen eksponentni povratek z motnjo za 429, 503 in ponovljive napake.
Obdelujte samo javne medije ali medije, do katerih imate dovoljen dostop. DRM in nadzori dostopa niso zaobšli.
Shranjujte ID-je zahtev in ID-je opravil v zasebnih operativnih dnevnikih. Ne beležite nepotrebno poslanih URL-jev.

DownF organizira dostop do Sheme okoli aktivacije pred raziskovanjem. Njegov pogled združljivosti primerja dodeljeno avtentikacijo. Dokumentirane oblike zahtev ostajajo končna kontrola.

DOSTOP, KI GA PREGLEDUJE OPERATER

Aktivirajte prek podpore

Opis izdelka, napoved mesečnih klicev in seznam platform, ki jih mora analizirati. Podpora DownF bo potrdila zahtevane obsege pred izdajo enkratnega vidnega poverilnice, katere shranjena kopija je le zgoščena vrednost.

Zahtevajte aktivacijo Ključi so omejeni na najemnika, preklicljivi in izdani prek kontaktnega obrazca. Anonimni skripti ne morejo izvajati nalog prenašalnika.