Pouze náhled — vyžaduje aktivaci

Sestavte stahování s SaveTK

SaveTK zobrazuje plán API pro integrace s nástroji pro tvůrce, ale nepřijímá neautentizované provádění. Schválení poskytuje jak klíč, tak jeho provozní limity.

SaveTkCreatorJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

SaveTK představuje tři praktické body pro API host. Prvním jsou přihlašovací údaje aktivované podporou. Pracovní postup ukládání pak pokrývá přiřazený koncový bod tenanta. Jeho posledním bodem je cesta volání pouze pro server.

URL klientahttps://savetk.app

AutentizaceX-API-Key: pending_activation_…

Profil klientaSaveTkCreator

Verze APIv1

# 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"}'

SaveTK usnadňuje kontrolu zabezpečení přihlašovacích údajů. Stránka začíná serverovým ukládáním tajných údajů, pokračuje tím, že neobsahuje vkládání do klientského balíčku, a jasně uvádí, že nejsou žádné veřejné protokoly ani repozitáře.

Vyřešit odkaz

SaveTK představuje tři praktické body pro používání Resolve. Prvním je detekce zdroje. Pracovní postup ukládání pak pokrývá formáty z jednoho odeslaného URL. Jeho posledním bodem je, že se nevymýšlejí žádné výstupy.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`creator_link`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

SaveTK usnadňuje rychlé zjištění identifikátoru formátu. Stránka začíná vrácenou hodnotou beze změny, přechází k dostupnosti pro jednotlivé odkazy a jasně uvádí, že chybí odhadované označení kvality.

Vytvoření a sledování úlohy stahování

Vytvoření úlohy začíná asynchronní přípravou na SaveTK. Tento úsporný pracovní postup pak představuje krátký požadavek HTTP.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`creator_link`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`save_option`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave save_task.

2Stav hlasováníGET /v1/jobs/{save_task} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

curl https://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

SaveTK zpracovává dotazování úloh tím, že nejprve identifikuje počáteční čekání jednu sekundu. Poté pokračuje omezeným exponenciálním odkladem a má na zřeteli dočasné podepsané doručení.

Předvídatelné chyby

Chybová smlouva začíná jedním obalem mimo 2xx na SaveTK. Další pohled pokrývá ID žádosti o podporu. Stránka ponechává viditelné předvídatelné zpracování na straně klienta.

{
  "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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

SaveTK nastavuje povolení pracovního postupu tvůrce po prozkoumání očekávaného provozu a platforem pro zveřejňování v rozsahu.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

SaveTK představuje tři praktické body pro přístup ke schématu. Prvním je aktivace před průzkumem. Pracovní postup ukládání pak zahrnuje přiřazené ověřování. Jeho posledním bodem jsou zdokumentované tvary požadavků.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Uveďte, co klient SaveTK dělá, kolik hovorů očekává a které služby pro publikování jsou nezbytné. Kontrola podpory vybere své oblasti působnosti a poté vrátí neobnovitelné přihlašovací údaje zobrazené pouze jednou.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.