Csak előzetes verzió – aktiválás szükséges

Letöltések készítése downf.io segítségével

A DownF az API végrehajtását letiltva tartja, amíg egy operátor át nem tekinti a kompatibilitási használati esetet. A példák a tervezett szerződést írják le, míg a valós hitelesítő adatok és kvóták csak a támogatás aktiválásán keresztül érkeznek.

DownfBridgeJSON HTTPS-en keresztülAszinkron feladatokHatókörrel rendelkező hitelesítő adatok

Gyors kezdés

A DownF az API-gazdaszervereket a támogatás által aktivált hitelesítő adatok köré szervezi. A kompatibilitási nézete összehasonlítja a hozzárendelt bérlő végpontot.

Bérlő URL-jehttps://downf.io

HitelesítésX-API-Key: pending_activation_…

Az ügyfél profiljaDownfBridge

Az API verzió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"}'

A hitelesítő adatok biztonsága a szerveroldali titkos tárolással kezdődik a DownF-en. Ez a kompatibilitási nézet nem tartalmaz kliens csomag beágyazást. A végső tény, hogy nincsenek nyilvános naplók vagy adattárak.

Hivatkozás feloldása

A DownF a Resolve műveletet a forrásfelismerés köré szervezi. Kompatibilitási nézete összehasonlítja a formátumokat egy benyújtott URL-ről.

POST/v1/resolveHatály: megoldani

Mező	Típus	Kötelező	Leírás
`media_address`	HTTPS URL	Igen.	Nyilvános vagy engedélyezett médiaoldal elemzése.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

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

A formátumazonosító a visszaadott értékkel kezdődik változatlanul a DownF-en. Ez a kompatibilitási nézet ezután bemutatja a linkenkénti elérhetőséget. A végső tény nem talált minőségi címke.

Letöltési feladat létrehozása és követése

A feladat létrehozása a DownF-en történő aszinkron előkészítéssel kezdődik. A következő nézet egy rövid HTTP kérést fed le, az oldalon látható marad a korlátozott munkavégzés.

POST/v1/jobsHatály: munkahelyek

Mező	Típus	Kötelező	Leírás
`media_address`	HTTPS URL	Igen.	Ugyanaz a normalizált forrás került benyújtásra megoldásra.
`output_ref`	karakterlánc	Igen.	Egy pontos azonosító a feloldási válaszból.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

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 ElfogadvaMentés transfer_ref.

2A szavazás állapotaGET /v1/jobs/{transfer_ref} ugyanazzal a kulccsal.

3KészNyissa meg az aláírt letöltési URL-t.

Állapot	Jelentése	Ügyfél akció
`queued`	Felvétel a korlátozott várólistára.	Újra szavazás hátraléptetéssel.
`extracting`	Forrás metaadatok vagy útvonal frissítése.	Folytasd a szavazás.
`processing`	Letöltés, remuxing vagy egyesítés.	Kiszolgáló előrehaladásának megjelenítése.
`ready`	Aláírt letöltés elérhető.	Küldje el az URL-t a felhasználónak.
`failed`	Terminál strukturált hiba.	Olvasd el `error_code`Csak akkor próbálkozzon újra, ha azt tanácsolják.
`expired`	Az ideiglenes kimenetet eltávolították.	Hozzon létre egy új feladatot.

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

A DownF kompatibilitási nézete áttekinti az egy másodperces kezdeti várakozást a Job polling számára. Ez a következő korlátozott visszavonást mutatja, és nem homályosítja az ideiglenes aláírt kézbesítést.

Kiszámítható hibák

A DownF három gyakorlati pontot mutat be az Error szerződéshez. Először jön egy nem 2xx boríték. A kompatibilitási nézet ezután lefedi a támogatási kérés azonosítóját. Az utolsó pontja az előre jelezhető klienskezelés.

{
  "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	Tipikus jelentése	Akció
400	Érvénytelen URL, tartalom vagy nem elérhető formátum.	Javítsa a kérést. Oldja meg újra a formátumokért.
401	Hiányzó, érvénytelen, lejárt vagy rossz hatókörű kulcs.	Ellenőrizze a kiszolgálóoldali hitelesítő adatokat.
403	A bérlő vagy a forrás irányelve elutasította a kérést.	Ne kerülje meg a szabályzatot. Lépjen kapcsolatba a támogatással.
404	Ismeretlen vagy lejárt munka.	Ha szükséges, hozzon létre egy új feladatot.
429	Kérés vagy aktív feladat limit elérve.	Becsület `retry_after_seconds`.
503	Sor/kapacitás vagy upstream ideiglenesen nem elérhető.	Próbálja újra exponenciális visszalépéssel és jitterrel.

Üzemeltetési szerződés

A DownF a kívánt ügyfél áttekintése után kérésplafont rendel hozzá, megtartva kompatibilitási ellenőrzéseit és a felfelé irányuló szolgáltatókat stabilan.

Használjon idempotens alkalmazáslogikát, és soha ne indítson párhuzamos feladatokat ugyanahhoz a felhasználói kattintáshoz.
A gyorsítótár oldja meg a metaadatokat röviden, de a aláírt letöltési URL-eket mindig lejártnak tekintse.
Használjon korlátozott exponenciális visszalépést jitterrel 429, 503 és újrapróbálható hibák.
Csak nyilvános vagy olyan médiafájlokat dolgozzon fel, amelyekhez Ön jogosult hozzáférni, és ne kerülje meg a DRM-et és a hozzáférés-vezérlést.
Tartsa meg a kérésazonosítókat és a feladatazonosítókat a privát működési naplókban. Ne naplózza szükségtelenül a beküldött URL-eket.

A DownF a Sémához való hozzáférést az aktiválás köré szervezi a felfedezés előtt. Kompatibilitási nézete összehasonlítja a hozzárendelt hitelesítést. A dokumentált kérésformák maradnak az utolsó ellenőrzés.

ÜZEMELTETŐ ÁLTAL ELLENŐRZÖTT HOZZÁFÉRÉS

Aktiválás a támogatáson keresztül

Írd le a terméket, becsüld meg havi hívásait, és sorold fel azokat a platformokat, amelyeket elemeznie kell. Az DownF támogatás megerősíti a szükséges hatásköröket, mielőtt kiad egy egyszeri látható hitelesítő adatot, amelynek tárolt másolata csak egy hash.

Aktiválás kérése A kulcsok bérlői hatókörűek, visszavonhatók, és a Kapcsolatfelvételi űrlapon keresztül adhatóak ki. Névtelen parancsfájlok nem tudnak letöltő munkát végrehajtani.