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

DWYT letöltések készítése

A DWYT kódpéldák dokumentálják a jövőbeli kéréssorozatot. A gyártási hívások zárva maradnak, amíg a videó kliens áttekintése és az operátor által hozzárendelt hitelesítő adatok engedélyezése meg nem történik.

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

Gyors kezdés

A DWYT formátumtérkép támogatott hitelesítő adatokat tekint át az API hoszt számára. Megjeleníti a hozzárendelt bérlői végpontot, és nem takarja el a kizárólag szerverhívás útvonalát.

Bérlő URL-jehttps://dwyt.app

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

Az ügyfél profiljaDwytFlow

Az API verziójav1

# Available only after support activation
export DWYT_FLOW_SECRET="issued-after-review"

curl -X POST https://dwyt.app/v1/resolve \
  -H "X-API-Key: $DWYT_FLOW_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"public_media":"https://www.youtube.com/watch?v=VIDEO_ID"}'

A hitelesítő adatok biztonsága érdekében a DWYT szerveroldali titkos tárolással kezdődik. Ennek formátumtérképe nem tartalmaz klienscsomag beágyazást, és nem végződik nyilvános naplókkal vagy adattárakkal.

Hivatkozás feloldása

A DWYT formátumtérképe áttekinti a forrásfelismerést a Feloldás művelethez. Megjeleníti az egy benyújtott URL formátumait, és nem takarja el a nem létrehozott kimeneteket.

POST/v1/resolveHatály: megoldani

Mező	Típus	Kötelező	Leírás
`public_media`	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ó esetében a DWYT változatlanul kezdi a visszaadott értéket. Formátumtérképe párosítja ezt a linkenkénti elérhetőséggel, és nem zár le feltételezett minőségi címkével.

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

A Feladat létrehozásakor a DWYT aszinkron előkészítést ellenőriz rövid HTTP-kérés előtt. Ez a formátumtérkép szintén egyértelművé teszi a kötött munkavégzést.

POST/v1/jobsHatály: munkahelyek

Mező	Típus	Kötelező	Leírás
`public_media`	HTTPS URL	Igen.	Ugyanaz a normalizált forrás került benyújtásra megoldásra.
`rendition_key`	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://dwyt.app/v1/jobs \
  -H "X-API-Key: $DWYT_FLOW_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"public_media":"https://www.youtube.com/watch?v=VIDEO_ID","rendition_key":"18"}'

1202 ElfogadvaMentés flow_id.

2A szavazás állapotaGET /v1/jobs/{flow_id} 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://dwyt.app/v1/jobs/FLOW_ID \
  -H "X-API-Key: $DWYT_FLOW_SECRET"

A munka lekérdezése egy másodperces kezdeti várakozással kezdődik a DWYT-en. Ez a formátumtérkép korlátozott visszalépést mutat be. A végső tény ideiglenes aláírt kézbesítés.

Kiszámítható hibák

A DWYT kezeli a Hibaszerződést azzal, hogy először azonosít egy nem 2xx borítékot. Ezt követi egy támogatási kérelem azonosító, és előre látható klienskezelést tart szem előtt.

{
  "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 DWYT áttekinti az integrációt, mielőtt kiválasztaná a kvótákat, amelyek védik mind a videoklienst, mind a felfelé irányuló szolgáltatásokat.

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 DWYT formátumtérkép aktiválásának áttekintése a séma-hozzáférés feltérképezése előtt történik. Megjeleníti a hozzárendelt hitelesítést, és nem takarja el a dokumentált kérésformákat.

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

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

Magyarázza el a kérés mögötti alkalmazást, annak havi forgalmi becslését és a használt videószolgáltatásokat. A DWYT áttekinti ezeket a részleteket, hozzárendeli a szükséges API jogosultságokat, és nem tárol visszanyerhető kulcsértéket.

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.