Pouze náhled — vyžaduje aktivaci

Sestavte stahování s downf.io

DownF udržuje spuštění API deaktivované, dokud operátor nezkontroluje případ použití kompatibility. Příklady popisují plánovanou smlouvu, zatímco skutečné přihlašovací údaje a kvóty dorazí až prostřednictvím aktivace podporou.

DownfBridgeJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

Jeho zobrazení kompatibility porovnává přiřazený koncový bod klienta. Konečnou kontrolou zůstává cesta volání pouze na serveru.

URL klientahttps://downf.io

AutentizaceX-API-Key: pending_activation_…

Profil klientaDownfBridge

Verze 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čnost přihlašovacích údajů začíná serverovým ukládáním tajných údajů na DownF. Toto zobrazení kompatibility pak nepředstavuje žádné vkládání klientského balíčku. Konečným faktem je absence veřejných protokolů nebo repozitářů.

Vyřešit odkaz

DownF organizuje Resolve operace kolem detekce zdroje. Jeho kompatibilní pohled porovnává formáty z jedné odeslané URL. Žádné vymyšlené výstupy zůstává konečná kontrola.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`media_address`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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

Identifikátor formátu začíná vrácenou hodnotou beze změny na DownF. Toto zobrazení kompatibility pak představuje dostupnost pro jednotlivé odkazy.

Vytvoření a sledování úlohy stahování

Vytvoření úlohy začíná asynchronní přípravou na DownF. Další pohled pokrývá krátký HTTP požadavek, stránka udržuje viditelné provádění bounded workeru.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`media_address`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`output_ref`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave transfer_ref.

2Stav hlasováníGET /v1/jobs/{transfer_ref} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

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

Zobrazuje omezený zpětný odběr vedle a nezakrývá dočasné podepsané doručení.

Předvídatelné chyby

DownF představuje tři praktické body pro Error contract. Nejprve přichází jeden obal mimo 2xx. Pohled na kompatibilitu pak zahrnuje ID požadavku na podporu. Jeho závěrečným bodem je předvídatelné zpracování na straně 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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

DownF přiřadí strop požadavku po přezkoumání zamýšleného klienta, udržuje jeho kontroly kompatibility a poskytovatele proti proudu stabilní.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

DownF organizuje přístup ke schématu kolem aktivace před průzkumem. Jeho režim kompatibility porovnává přiřazenou autentizaci. Dokumentované tvary požadavků zůstávají konečnou kontrolou.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Popište produkt, předvídejte jeho měsíční volání a uveďte platformy, které musí analyzovat. Podpora DownF potvrdí požadované rozsahy před vydáním jednorázového viditelného přihlašovacího údaje, jehož uložená kopie je pouze hash.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.