Len ukážka – vyžaduje sa aktivácia

Zostavte si stiahnutia s downf.io

DownF ponecháva vykonávanie API vypnuté, kým operátor neposúdi prípad použitia z hľadiska kompatibility. Príklady opisujú plánované správanie; skutočné prihlasovacie údaje a kvóty budú dostupné až po aktivácii podpory.

DownfBridgeJSON cez HTTPSAsynchrónne úlohyPoverenia s rozsahom

Rýchly štart

DownF prevádzkuje API hostiteľa s prihlasovacími údajmi aktivovanými podporou. V prehľade kompatibility sa porovnáva priradený koncový bod tenanta. Záverečnú kontrolu vykonáva výhradne serverová cesta volania.

URL nájomcuhttps://downf.io

AutentifikáciaX-API-Key: pending_activation_…

Profil klientaDownfBridge

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

Bezpečné nakladanie s prihlasovacími údajmi sa v DownF začína ukladaním tajomstiev na serveri. Toto zobrazenie kompatibility zároveň uvádza, že tajomstvá nie sú vložené do klientského balíka a že neexistujú verejné záznamy ani repozitáre.

Vyriešiť odkaz

Služba DownF v kroku rozpoznania najprv identifikuje zdroj. Prehľad kompatibility porovnáva formáty podľa zadanej adresy URL. Záverečnou kontrolou je overenie, že výstupy neboli domyslené.

POŠTA/v1/resolveRozsah: vyriešiť

Pole	Typ	Povinné	Popis
`media_address`	HTTPS URL	Áno	Verejná alebo oprávnená mediálna stránka na analýzu.
`tenant`	reťazec	Nie	Priradená doména nájomníka. Zvyčajne sa vynecháva.

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

Identifikátor formátu sa v DownF začína vrátenou hodnotou bez akejkoľvek úpravy. Tento prehľad kompatibility následne uvádza dostupnosť pre každý odkaz. Nepriraďuje sa odhadnuté označenie kvality.

Vytvorte a sledujte úlohu sťahovania

V DownF sa vytvorenie úlohy začína asynchrónnou prípravou. Nasledujúci prehľad sa týka krátkej HTTP požiadavky. Stránka jasne uvádza, že spracovanie pracovníkom má pevné limity.

POŠTA/v1/jobsRozsah: pracovné ponuky

Pole	Typ	Povinné	Popis
`media_address`	HTTPS URL	Áno	Rovnaký normalizovaný zdroj predložený na vyriešenie.
`output_ref`	reťazec	Áno	Presné ID z odpovede na vyriešenie.
`tenant`	reťazec	Nie	Priradená doména nájomníka. Zvyčajne sa vynecháva.

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 prijatéUložiť transfer_ref.

2Stav anketyGET /v1/jobs/{transfer_ref} s rovnakým kľúčom.

3PripravenýOtvorte podpísanú URL adresu na stiahnutie.

Stav	Význam	Akcia klienta
`queued`	Prijatý do ohraničeného frontu.	Anketa znova s odstupom.
`extracting`	Obnovovanie zdrojových metadát alebo trasy.	Pokračujte v hlasovaní.
`processing`	Sťahovanie, remuxovanie alebo spájanie.	Zobrazenie priebehu servera.
`ready`	Podpísané stiahnutie je k dispozícii.	Odoslanie URL adresy používateľovi.
`failed`	Terminál štruktúrovaná chyba.	Čítať `error_code`Opakujte pokus iba v prípade, že vám to odporučia.
`expired`	Dočasný výstup bol odstránený.	Vytvorte novú úlohu.

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

Prehľad kompatibility DownF uvádza úvodné čakanie jednu sekundu pri zisťovaní stavu úlohy. Následne zobrazuje obmedzené predlžovanie intervalov a nezakrýva dočasné doručenie pomocou podpísaného odkazu.

Predvídateľné chyby

DownF uvádza tri praktické časti chybového kontraktu: jednu odpoveď s kódom mimo rozsahu 2xx, identifikátor požiadavky na podporu v zobrazení kompatibility a predvídateľné spracovanie na strane klienta.

{
  "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	Typický význam	Akcia
400	Neplatná adresa URL, telo alebo nedostupný formát.	Opravte požiadavku. Vyriešte znova pre formáty.
401	Chýbajúci, neplatný, neplatný alebo nesprávny rozsah kľúča.	Skontrolujte poverenie na strane servera.
403	Nájomca alebo zdrojová politika odmietli žiadosť.	Neobchádzajte pravidlá. Obráťte sa na podporu.
404	Neznáma alebo vypršaná pracovná ponuka.	V prípade potreby vytvorte novú úlohu.
429	Dosiahnutý limit požiadaviek alebo aktívnych úloh.	Česť `retry_after_seconds`.
503	Fronta/kapacita alebo upstream dočasne nedostupné.	Skúste to znova s exponenciálnym spätným odrazom a jitterom.

Prevádzková zmluva

DownF nastavuje limit požiadaviek po posúdení zamýšľaného klienta, aby zostali kontroly kompatibility aj nadväzujúci poskytovatelia stabilní.

Používajte idempotentnú aplikačnú logiku a nikdy nespúšťajte duplicitné úlohy pre to isté kliknutie používateľa.
Vyrovnávacia pamäť vyriešiť metadáta krátko, ale vždy zaobchádzať podpísané stiahnuť URL ako vypršať.
Použite ohraničený exponenciálny spätný chod s jitterom pre 429, 503 a opakovatelné chyby.
Spracovávajte iba verejné médiá alebo médiá, ku ktorým máte oprávnený prístup. DRM a kontroly prístupu nie sú obídené.
Uchovávajte ID žiadostí a ID úloh v súkromných prevádzkových denníkoch. Nezapisujte odoslané adresy URL zbytočne.

DownF organizuje prístup k Schema tak, že aktivácia predchádza skúmaniu. V prehľade kompatibility sa porovnáva pridelené overenie. Záverečnou kontrolou sú zdokumentované podoby požiadaviek.

PRÍSTUP KONTROLOVANÝ OPERAČOM

Aktivácia prostredníctvom podpory

Opíšte produkt, odhadnite počet jeho volaní za mesiac a uveďte platformy, ktoré musí analyzovať. Podpora DownF pred vydaním jednorazového, pri vytvorení zobrazovaného prihlasovacieho údaja potvrdí požadované rozsahy oprávnení; uložená kópia bude obsahovať iba jeho hash.

Požiadať o aktiváciu Kľúče sú viazané na nájomníka, možno ich odvolať a vydávajú sa prostredníctvom kontaktného formulára. Anonymné skripty nemôžu vykonávať prácu sťahovača.