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

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

Ez a EasyT referencia egy megvalósítási útmutató, nem pedig aktív anonim végpont. A termelési hozzáférés csak a támogatás jóváhagyása és a korlátok hozzárendelése után kezdődik.

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

Gyors kezdés

Az API gazdagép a EasyT rendszeren támogatással aktivált hitelesítő adatokkal kezdődik. Ez az irányított ellenőrzés egy hozzárendelt bérlői végpontot mutat be. A végső tény egy kizárólag szerveroldali hívási útvonal.

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

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

Az ügyfél profiljaEasytWorkspace

Az API verziójav1

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

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

A EasyT esetében a szerveroldali titkos tárolás az első, amikor a hitelesítő adatok biztonságát magyarázzák. Ez az irányított ellenőrzés követi a klienscsomag beágyazásának hiányát, és a nyilvános naplók vagy tárolók hiányával zárul.

Hivatkozás feloldása

A feloldási művelet a forrás észlelésével kezdődik a EasyT-en. Ez az irányított ellenőrzés ezután egy benyújtott URL formátumait mutatja be. A végső tény, hogy nincs kitalált kimenet.

POST/v1/resolveHatály: megoldani

Mező	Típus	Kötelező	Leírás
`input_url`	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 EasyT oldalon a formátumazonosító magyarázatakor először a változatlan visszatérési érték jelenik meg. Ezt az irányított ellenőrzést az egyes linkek elérhetősége követi, és nem kerül megjelölésre minőségi címke feltételezés alapján.

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

Az aszinkron előkészítés a kiindulópont a Feladat létrehozásához a EasyT-en. Egy irányított ellenőrzés rövid HTTP-kérést mutat be, és elmagyarázza a kötött munkavégzést.

POST/v1/jobsHatály: munkahelyek

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

1202 ElfogadvaMentés workspace_job.

2A szavazás állapotaGET /v1/jobs/{workspace_job} 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://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

Az állásajánlat lekérdezéséhez a EasyT egy másodperces kezdeti várakozással indul. Az irányított ellenőrzés ezt korlátozott visszalépéssel párosítja, és ideiglenes aláírt kézbesítéssel zárul.

Kiszámítható hibák

A EasyT megkönnyíti a Hibaszerződés átvizsgálását. Az oldal egy nem 2xx-es borítékkal kezdődik, majd egy támogatási kérelem azonosítóhoz lép, és világosan megfogalmazza az előrelátható ügyfélkezelé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.

Üzemeltetési szerződés

A EasyT a felülvizsgálat során kiválaszt egy működési juttatást, egyensúlyt teremtve az alkalmazás igényei és a szolgáltató egészsége között.

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 sémahozzáférés aktiválással kezdődik, mielőtt a EasyT rendszeren felfedezés történik. Ez az irányított ellenőrzés ezután bemutatja a hozzárendelt hitelesítést. A végső tény a dokumentált kérésformákat tartalmazza.

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

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

Az aktiválási megjegyzésben tüntesse fel az ügyfél célját, a várható havi munkaterhelést és a kért hálózatokat. A EasyT ezután helyesen választhatja ki a megoldandó és a munkaköröket, mielőtt elkészítené az egynézetes titkot.

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.