Esikatselu vain — aktivointi vaaditaan

Rakenna lataukset SaveTK: llä

SaveTK esittelee API-suunnitelman sisällöntuottajien työkalujen integraatioita varten, mutta ei hyväksy tunnistautumattomia kutsuja. Hyväksynnän yhteydessä annetaan sekä avain että sen käyttörajat.

SaveTkCreatorJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot

Pika-aloitus

SaveTK kuvaa API-palvelimen käytön kolmella kohdalla: tuen aktivoimat tunnistetiedot, asiakkaalle osoitettu päätepiste ja vain palvelimelta tehtävät kutsut.

Vuokraajan URL- osoitehttps://savetk.app

TodentaminenX-API-Key: pending_activation_…

AsiakasprofiiliSaveTkCreator

API-versiov1

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

Palvelussa SaveTK salaiset tunnistetiedot säilytetään palvelimella. Niitä ei sisällytetä asiakasohjelman tiedostoihin eikä julkisiin lokeihin tai koodivarastoihin.

Linkin ratkaiseminen

SaveTK kuvaa linkin tietojen selvittämisen kolmella kohdalla: lähteen tunnistus, yhdelle lähetetylle osoitteelle saatavilla olevat muodot ja se, ettei tuloksia keksitä.

POSTI/v1/resolveLaajuus: ratkaista

Kenttä	Tyyppi	Pakollinen	Kuvaus
`creator_link`	HTTPS- URL	- Kyllä.	Julkinen tai valtuutettu mediapohja analysoitavaksi.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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

Palvelussa SaveTK muodon tunnistetta käytetään sellaisena kuin se palautetaan. Saatavuus tarkistetaan linkkikohtaisesti, eikä laatumerkintöjä arvata.

Luo ja seuraa lataustehtävää

Palvelussa SaveTK tehtävä luodaan lyhyellä HTTP-pyynnöllä ja valmistelu tehdään asynkronisesti. Työntekijän suoritus on rajattu.

POSTI/v1/jobsLaajuus: työpaikat

Kenttä	Tyyppi	Pakollinen	Kuvaus
`creator_link`	HTTPS- URL	- Kyllä.	Sama normalisoitu lähde lähetetty ratkaistavaksi.
`save_option`	merkkijono	- Kyllä.	Tarkka tunnus ratkaisuvasteesta.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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 HyväksyttyTallenna save_task.

2Kyselyn tilaGET /v1/jobs/{save_task} samalla avaimella.

3Valmiina.Avaa allekirjoitettu lataus-URL.

Tila	Merkitys	Asiakastoiminta
`queued`	Pääsi rajattuun jonoon.	Kysely uudelleen takaisinvedolla.
`extracting`	Päivitetään lähdemetatietoja tai reittiä.	Jatka äänestystä.
`processing`	Ladataan, remuxataan tai yhdistetään.	Näytä palvelimen edistyminen.
`ready`	Allekirjoitettu lataus on saatavilla.	Lähetä URL-osoite käyttäjälle.
`failed`	Päätelaitteen rakenteellinen virhe.	Lue `error_code`Yritä uudelleen vain, kun sitä kehotetaan.
`expired`	Väliaikainen tuotos poistettiin.	Luo uusi työpaikka.

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

Palvelussa SaveTK tehtävän tilan kysely alkaa yhden sekunnin odotuksella. Sen jälkeen kyselyväliä kasvatetaan määritettyyn enimmäisrajaan asti. Tiedosto toimitetaan väliaikaisella allekirjoitetulla latauslinkillä.

Ennustettavat virheet

Palvelun SaveTK virhevastauksissa käytetään yhtenäistä vastausrakennetta HTTP-tilakoodeille, jotka eivät kuulu 2xx-ryhmään. Vastauksessa annetaan tukipyyntöä varten pyynnön tunniste, jotta asiakasohjelma voi käsitellä virheet ennakoitavasti.

{
  "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	Tyypillinen merkitys	Toimi
400	Virheellinen URL-osoite, sisältö tai formaatti ei ole saatavilla.	Korjaa pyyntö. Ratkaise uudelleen formaateille.
401	Puuttuva, virheellinen, vanhentunut tai väärän laajuuden avain.	Tarkista palvelinpuolen tunnistetiedot.
403	Vuokralaisen tai lähdepolitiikan pyyntö hylättiin.	Älä ohita käytäntöä. Ota yhteyttä tukeen.
404	Tuntematon tai vanhentunut työpaikka.	Luo uusi tehtävä, jos tarpeen.
429	Pyyntö- tai aktiivisten tehtävien raja saavutettu.	Kunnia. `retry_after_seconds`.
503	Jono/kapasiteetti tai ylävirta tilapäisesti poissa käytöstä.	Yritä uudelleen eksponentiaalisella viiveellä ja häiriöllä.

Toiminnan sopimus

SaveTK määrittää sisällöntuottajien työnkulkujen käyttörajat arvioituaan odotetun liikenteen ja käytettävät julkaisualustat.

Käytä idempotenttia sovelluslogiikkaa äläkä koskaan käynnistä päällekkäisiä tehtäviä saman käyttäjän klikkauksesta.
Välimuisti ratkaisee metatiedot lyhyesti, mutta käsittelee aina allekirjoitettuja lataus-URL-osoitteita vanhenevina.
Käytä rajattua eksponentiaalista takaisinkytkentää häiriöllä varten 429, 503 ja uudelleenyritettävä virheitä.
Käsittele vain julkista mediaa tai mediaa, johon sinulla on oikeus. DRM- ja käyttöoikeusrajoituksia ei kiertää.
Pidä pyyntö- ja työn tunnukset yksityisissä toimintalokeissa. Älä kirjaa lähetettyjä URL-osoitteita tarpeettomasti.

SaveTK kuvaa rajapintaskeeman käytön kolmella kohdalla: käyttö aktivoidaan ennen tutustumista, käytetään annettuja tunnistautumistietoja ja noudatetaan dokumentoituja pyyntörakenteita.

TOIMIJAN TARKASTAMALLA PÄÄSY

Aktivoi tuen kautta

Kerro, mitä SaveTK-asiakasohjelma tekee, kuinka monta kutsua se odottaa ja mitkä julkaisupalvelut ovat välttämättömiä. Tukitarkistus määrittää käyttöoikeuksien laajuuden ja antaa kerran näytettävän tunnisteen, jota ei voi myöhemmin palauttaa.

Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.