https://dwtt.appÉpíts letöltéseket DWTT segítségével
A DWTT ezt az integrációs vázlatot tervezésre teszi közzé, nem anonim végrehajtásra. A támogatásnak jóvá kell hagynia a klip munkafolyamatot a hatókörhöz rendelt kulcs és a hozzá tartozó forgalmi keret kiadása előtt.
DwttToolkitJSON HTTPS-en keresztülAszinkron feladatokHatókörrel rendelkező hitelesítő adatok
01
Gyors kezdés
DWTT könnyen beolvashatóvá teszi az API hostot. Az oldal támogatás által aktivált hitelesítő adatokkal kezdődik, egy hozzárendelt tenant végpontra vált, és egyértelműen jelzi a csak kiszolgálóról hívható elérési utat.
X-API-Key: pending_activation_…DwttToolkitv1# Available only after support activation
export DWTT_TOOL_TOKEN="issued-after-review"
curl -X POST https://dwtt.app/v1/resolve \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'DWTT a hitelesítő adatok biztonságát kiszolgálóoldali titoktároláson keresztül közelíti meg, majd nem ágyaz be semmit az ügyféloldali csomagba. Az egyszerűsített munkafolyamat nem tesz nyilvánossá naplókat vagy tárolókat.
02
Hivatkozás feloldása
A DWTT megkönnyíti a Resolve művelet átvizsgálását. Az oldal forrásfelismeréssel kezdődik, egy beküldött URL-ből a formátumokra tér át, és egyértelműen jelzi, hogy nincsenek kitalált kimenetek.
POST
/v1/resolveHatály: megoldani| Mező | Típus | Kötelező | Leírás |
|---|---|---|---|
source_link | 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
}DWTT a visszaadott értéken változatlanul keresztül közelíti meg a formátumazonosítót, majd hivatkozásonkénti elérhetőségen át. Az egyszerűsített munkafolyamat nem tesz explicit módon feltételezett minőségi címkét.
03
Letöltési feladat létrehozása és követése
A DWTT-ben a feladat létrehozásának magyarázatakor az aszinkron előkészítés áll az első helyen. Ezt az egyszerűsített munkafolyamatot egy rövid HTTP-kérés követi, és a korlátozott worker-végrehajtással zárul.
POST
/v1/jobsHatály: munkahelyek| Mező | Típus | Kötelező | Leírás |
|---|---|---|---|
source_link | HTTPS URL | Igen. | Ugyanaz a normalizált forrás került benyújtásra megoldásra. |
format_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://dwtt.app/v1/jobs \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID","format_ref":"18"}'task_ref.GET /v1/jobs/{task_ref} ugyanazzal a kulccsal.| Á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_codeCsak 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://dwtt.app/v1/jobs/TASK_REF \
-H "X-API-Key: $DWTT_TOOL_TOKEN"A Job polling magyarázatához a DWTT elkülöníti az egy másodperces kezdeti várakozást a korlátozott visszalépéstől. Az egyszerűsített munkafolyamat külön helyet ad az ideiglenes aláírt kézbesítésnek.
04
Kiszámítható hibák
Egy nem 2xx boríték a kiindulópont a DWTT hibaszerződéséhez. Ezután egy leegyszerűsített munkafolyamat megjeleníti a támogatási kérelem azonosítóját, és ismerteti az előre jelezhető kliensoldali kezelést.
{
"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. |
05
Üzemeltetési szerződés
DWTT forgalmi engedélyeket állít be az aktiválás során, hogy a klipintegrációk és a forrás hálózatok ne legyenek túlterhelve.
- 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 DWTT könnyen áttekinthetővé teszi a Schema hozzáférést. Az oldal az aktiválással kezdődik a felfedezés előtt, majd a hozzárendelt hitelesítésre tér át, és egyértelműen közli a dokumentált kérésformákat.
Aktiválás a támogatáson keresztül
Küldd el a DWTT számára a tervezett integrációt, valószínűleg a kérések mennyiségét és a célhálózatokat. Jelezd, hogy az ügyfélnek feloldásra, feladat létrehozására vagy mindkettőre van-e szüksége, যাতে egy korlátozott kulcs jóváhagyható és egyszer jeleníthető meg.
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.