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

Letöltések összeállítása a EasyF segítségével

A EasyF előre megjeleníti a felületet, hogy a fejlesztők felmérhessék munkájukat. Támogatói felülvizsgálat még mindig szükséges, mielőtt élő kulcs és használati határ létezne.

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

Gyors kezdés

Az API hoszt magyarázatához a EasyF elkülöníti a támogatás által aktivált hitelesítő adatokat a hozzárendelt bérlői végponttól. Egy egyszerű nyelvű munkafolyamat saját helyet ad a kizárólag szerveroldali hívási útnak.

Bérlő URL-jehttps://easyf.app
HitelesítésX-API-Key: pending_activation_…
Az ügyfél profiljaEasyfClient
Az API verziójav1
# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

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

A hitelesítő adatok biztonsága a EasyF szerveroldali titkos tárolásával kezdődik. A következő nézet nem tartalmaz kliens csomag beágyazást. Az oldal nem tart nyilván nyilvános naplókat vagy látható adattárakat.

02

Hivatkozás feloldása

A Resolve művelet magyarázatához a EasyF elkülöníti a forrásfelismerést a formátumoktól egy beküldött URL alapján. Egy közérthető munkafolyamat nem ad találomra kitalált kimeneteknek saját helyet.

POST/v1/resolveHatály: megoldani
MezőTípusKötelezőLeírás
asset_urlHTTPS URLIgen.Nyilvános vagy engedélyezett médiaoldal elemzése.
tenantkarakterláncNem.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 visszakapott értékkel változatlanul kezdődik a EasyF-nél. A következő nézet az egyes linkek elérhetőségét fedi le. Az oldal nem tart fenn semmilyen tippelt minőségi címkét láthatóan.

03

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

A EasyF három gyakorlati pontot mutat be az állás létrehozásához. Először jön az aszinkron előkészítés. Az egyszerű nyelvű munkafolyamat ezután lefedi a rövid HTTP-kérést. Az utolsó pontja a korlátozott munkavégzés.

POST/v1/jobsHatály: munkahelyek
MezőTípusKötelezőLeírás
asset_urlHTTPS URLIgen.Ugyanaz a normalizált forrás került benyújtásra megoldásra.
variant_codekarakterláncIgen.Egy pontos azonosító a feloldási válaszból.
tenantkarakterláncNem.Hozzárendelt bérlői domain. Általában elhagyható.
curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'
1202 ElfogadvaMentés delivery_id.
2A szavazás állapotaGET /v1/jobs/{delivery_id} ugyanazzal a kulccsal.
3KészNyissa meg az aláírt letöltési URL-t.
ÁllapotJelentéseÜgyfél akció
queuedFelvétel a korlátozott várólistára.Újra szavazás hátraléptetéssel.
extractingForrás metaadatok vagy útvonal frissítése.Folytasd a szavazás.
processingLetöltés, remuxing vagy egyesítés.Kiszolgáló előrehaladásának megjelenítése.
readyAláírt letöltés elérhető.Küldje el az URL-t a felhasználónak.
failedTerminál strukturált hiba.Olvasd el error_codeCsak akkor próbálkozzon újra, ha azt tanácsolják.
expiredAz ideiglenes kimenetet eltávolították.Hozzon létre egy új feladatot.
curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

A EasyF az álláslekérdezést egy másodperces kezdeti várakozással közelíti meg, majd korlátozott visszalépéssel. Az egyszerű nyelvű munkafolyamat egyértelművé teszi az ideiglenes aláírt kézbesítést.

04

Kiszámítható hibák

A EasyF egyetlen nem 2xx boríték köré szervezi a Hibaszerződést. Egyszerű nyelvű munkafolyamata összehasonlít egy támogatási kérés azonosítót. A kiszámítható klienskezelés marad az utolsó ellenőrzé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": "…"
}
HTTPTipikus jelentéseAkció
400Érvénytelen URL, tartalom vagy nem elérhető formátum.Javítsa a kérést. Oldja meg újra a formátumokért.
401Hiányzó, érvénytelen, lejárt vagy rossz hatókörű kulcs.Ellenőrizze a kiszolgálóoldali hitelesítő adatokat.
403A 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.
404Ismeretlen vagy lejárt munka.Ha szükséges, hozzon létre egy új feladatot.
429Kérés vagy aktív feladat limit elérve.Becsület retry_after_seconds.
503Sor/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

A EasyF gyakorlati használati határokat egyeztet minden jóváhagyott termékkel a kiszámítható, irányított munkafolyamat megőrzése érdekében.

A Schema-hozzáférés magyarázatához a EasyF elkülöníti az aktiválást a felfedezés előtti és a hozzárendelt hitelesítés között. Egy közérthető munkafolyamat dokumentált kérések formáit saját helyükre teszi.

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

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

Mondd meg a EasyF-nek, mit építesz, milyen gyakran fogja hívni az API-t, és mely szolgáltatók számítanak. Az ellenőrzés dönt a megengedett műveletekről, majd egyszer felfedi a hitelesítő adatot, miközben csak annak biztonságos kivonatát menti el.

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.