Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med SaveTK

SaveTK viser en API-plan for integrasjoner med verktøy for skapere, men godtar ikke uautentisert utførelse. Godkjenning leverer både nøkkelen og dens driftsgrenser.

SaveTkCreatorJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

SaveTK presenterer tre praktiske punkter for API-vert. Først kommer støtte-aktiverte legitimasjoner. Lagrearbeidsflyten dekker deretter et tildelt leietakerendepunkt. Det siste punktet er en serverkun kallsti.

Leietaker-URLhttps://savetk.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilSaveTkCreator

API-versjonv1

# 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 gjør det enkelt å skanne legitimasjonssikkerhet. Siden starter med server-side hemmelig lagring, går videre til ingen klientpakke-innbygging, og angir tydelig ingen offentlige logger eller arkiver.

Løse en kobling

SaveTK presenterer tre praktiske punkter for Resolve-operasjon. Først kommer kildeoppdagelse. Lagrearbeidsflyten dekker deretter formater fra én innsendt URL. Det siste punktet er ingen oppdiktede utdata.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`creator_link`	HTTPS-URL	Ja	Offentlig eller autorisert medieside å analysere.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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

SaveTK gjør Formatidentifikator lett å skanne. Siden starter med den returnerte verdien uendret, går videre til tilgjengelighet per lenke, og angir tydelig at det ikke er noen antatt kvalitetsmerkelapp.

Opprett og følg en nedlastingsjobb

Jobboppretting begynner med asynkron forberedelse på SaveTK. Denne lagringsarbeidsflyten presenterer deretter en kort HTTP-forespørsel. Det endelige faktum er begrenset arbeiderutførelse.

POST/v1/jobsOmfang: jobber

Felt	Type	Påkrevd	Beskrivelse
`creator_link`	HTTPS-URL	Ja	Den samme normaliserte kilden innlevert for å løse.
`save_option`	streng	Ja	En nøyaktig ID fra løsningssvaret.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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 AkseptertLagre@ action: button save_task.

2AvstemningsstatusGET /v1/jobs/{save_task} med samme nøkkel.

3KlarÅpne den signerte nedlastingsadressen.

Status	Betydning	Klienthandling
`queued`	Opptatt i den begrensede køen.	Avstemning igjen med baklengs.
`extracting`	Oppdaterer kildemetadata eller rute.	Fortsett å avstemme.
`processing`	Laster ned, remikser eller slår sammen.	Vis server fremgang.
`ready`	Signert nedlasting er tilgjengelig.	Send URL-adressen til brukeren.
`failed`	Terminalstrukturert feil.	Lest `error_code`Prøv på nytt bare når det anbefales.
`expired`	Midlertidig utgang ble fjernet.	Opprett en ny jobb.

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

SaveTK håndterer jobbspørring ved først å identifisere ett sekunds initial ventetid. Den følger opp med begrenset tilbakefall og holder midlertidig signert levering i sikte.

Forutsigbare feil

Feilkontrakt starter med ett ikke-2xx-konvolutt på SaveTK. Neste visning dekker en støtteforespørsels-ID. Siden holder forutsigbar klienthåndtering synlig.

{
  "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	Typisk betydning	Handling
400	Ugyldig URL, brødtekst eller utilgjengelig format.	Rett opp forespørselen. Løs igjen for formater.
401	Manglende, ugyldig, utløpt eller feil omfang nøkkel.	Sjekk server-side legitimasjon.
403	Leietaker eller kildepolicy avslo forespørselen.	Ikke omgå policyen. Kontakt kundestøtte.
404	Ukjent eller utløpt jobb.	Opprett en ny jobb om det er passende.
429	Grensen for forespørsler eller aktive jobber er nådd.	Ære `retry_after_seconds`.
503	Kø/kapasitet eller oppstrøms midlertidig utilgjengelig.	Prøv igjen med eksponentiell tilbakeslag og jitter.

Driftskontrakt

SaveTK setter tillatelser for skaper-arbeidsflyt etter å ha undersøkt forventet trafikk og de aktuelle publiseringsplattformene.

Bruk idempotent programlogikk og aldri starte dupliserte jobber for samme bruker klikk.
Cache løse metadata kort, men alltid behandle signerte nedlastingsadresser som utløper.
Bruk begrenset eksponentiell tilbakeslag med jitter for 429, 503 og gjentatte feil.
Behandle bare offentlige medier eller medier du har autorisert tilgang til. DRM og tilgangskontroller omgås ikke.
Oppbevar forespørsels-ID-er og jobb-ID-er i private driftslogger. Ikke logg innsendte URL-er unødvendig.

SaveTK presenterer tre praktiske punkter for Schema-tilgang. Først kommer aktivering før utforskning. Lagrearbeidsflyten dekker deretter tildelt autentisering. Det siste punktet er dokumenterte forespørselsformer.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Oppgi hva SaveTK-klienten gjør, hvor mange kall den forventer og hvilke posttjenester som er essensielle. Støttegjennomgangen velger sine omfang, og returnerer deretter en ikke-gjenopprettbar legitimasjon vist én gang.

Be om aktivering Nøklene er basert på leietakers omfang, kan tilbakekalles og utstedes via Kontaktskjemaet.