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

Letöltések készítése SaveTK segítségével

A SaveTK API tervet jelenít meg alkotóeszköz-integrációkhoz, de nem fogad el hitelesítés nélküli végrehajtást. A jóváhagyás biztosítja mind a kulcsot, mind annak működési korlátait.

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

Gyors kezdés

A SaveTK három gyakorlati pontot mutat be az API hoszt számára. Először a támogatás-aktivált hitelesítő adatok következnek. A mentési munkafolyamat ezután egy hozzárendelt bérlői végpontot fed le. Az utolsó pontja egy kizárólag szerveroldali hívási útvonal.

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

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

A SaveTK megkönnyíti a Credential biztonságának átvizsgálását. Az oldal a szerveroldali titkos tárolással kezdődik, átkerül a kliens köteg beágyazásának hiányára, és egyértelműen kimondja, hogy nincsenek nyilvános naplók vagy tárolók.

02

Hivatkozás feloldása

A SaveTK három gyakorlati pontot mutat be a Resolve művelethez. Először jön a forrásfelismerés. A mentési munkafolyamat ezután egy benyújtott URL formátumait fedi le. Az utolsó pontja, hogy nincs kitalált kimenet.

POST/v1/resolveHatály: megoldani
MezőTípusKötelezőLeírás
creator_linkHTTPS 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 SaveTK megkönnyíti a Formátumazonosító átfutását. Az oldal a visszakapott értékkel kezdődik változatlanul, áttér az egyes linkek elérhetőségére, és egyértelműen kijelenti, hogy nincs feltételezett minőségi címke.

03

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

A munka létrehozása aszinkron előkészítéssel kezdődik a SaveTK-en. Ez a mentési munkafolyamat ezután egy rövid HTTP-kérést mutat be. A végső tény a korlátolt munkavégzés.

POST/v1/jobsHatály: munkahelyek
MezőTípusKötelezőLeírás
creator_linkHTTPS URLIgen.Ugyanaz a normalizált forrás került benyújtásra megoldásra.
save_optionkarakterlá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://savetk.app/v1/jobs \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID","save_option":"18"}'
1202 ElfogadvaMentés save_task.
2A szavazás állapotaGET /v1/jobs/{save_task} 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://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

A SaveTK a munka lekérdezését egy másodperces kezdeti várakozás azonosításával kezeli. Ezt korlátozott visszalépés követi, és ideiglenes aláírt kézbesítést tart szem előtt.

04

Kiszámítható hibák

A hibaszerződés egy nem 2xx borítékkal kezdődik a SaveTK-en. A következő nézet egy támogatási kérelem azonosítóját fedi le. Az oldal kiszámítható klienskezelést tart láthatóan.

{
  "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 SaveTK a várható forgalom és a hatókörbe tartozó posztolási platformok vizsgálata után állítja be a készítői munkafolyamat engedélyeket.

A SaveTK három gyakorlati pontot mutat be a Sémához való hozzáféréshez. Először az aktiválás következik a felfedezés előtt. A mentési munkafolyamat ezután lefedi a hozzárendelt hitelesítést. Az utolsó pontja a dokumentált kérések formái.

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

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

Határozza meg, mit tesz a SaveTK kliens, hány hívást vár és mely közzétételi szolgáltatások elengedhetetlenek. A támogatási áttekintés kiválasztja a hatóköröket, majd visszaad egy nem visszanyerhető hitelesítő adatot, amely egyszer jelenik 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.