Kun prøveversion — aktivering kræves

Byg downloads med SaveTK

SaveTK viser en API-plan for integrationer mellem skaberen og værktøjet, men accepterer ikke udførelse uden godkendelse.

SaveTkCreatorJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

SaveTK præsenterer tre praktiske punkter for API-vært. Først kommer support-aktiverede legitimationsoplysninger. Gemmearbejdsgangen dækker derefter et tildelt lejer-endpoint. Det sidste punkt er en server-only opkaldsvej.

Lejer- URLhttps://savetk.app

GodkendelseX-API-Key: pending_activation_…

Profil af klientSaveTkCreator

Version af 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 Siden starter med server-side hemmelig opbevaring, flytter til ingen klient bundt indlejring, og klart angiver ingen offentlige logfiler eller repositories.

Løsning af et link

SaveTK præsenterer tre praktiske punkter for Resolve-drift. Først kommer kildeidentifikation. Gemmearbejdsgangen dækker derefter formater fra en indsendt URL. Det sidste punkt er ingen opfundne output.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`creator_link`	HTTPS- URL	Ja	Offentlig eller autoriseret medieside at analysere.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

SaveTK Siden starter med den returnerede værdi uændret, flytter til tilgængelighed pr. link og angiver tydeligt, at der ikke er nogen gættet kvalitetsmærke.

Opret og følg et downloadjob

Joboprettelse begynder med asynkron forberedelse på SaveTK. Denne besparelse arbejdsgang præsenterer derefter en kort HTTP-anmodning. Den endelige kendsgerning er afgrænset arbejdstager udførelse.

POST/v1/jobsOmfang: job

Felt	Type	Påkrævet	Beskrivelse
`creator_link`	HTTPS- URL	Ja	Den samme normaliserede kilde indsendt til at løse.
`save_option`	streng	Ja	Et nøjagtigt id fra forklaringssvaret.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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 AccepteretGem save_task.

2AfstemningsstatusGET /v1/jobs/{save_task} med samme nøgle.

3KlarÅbn den signerede download-URL.

Status	Betydning	Klienthandling
`queued`	Optaget i den afgrænsede kø.	Afstemning igen med tilbageslag.
`extracting`	Opdatering af kildemetadata eller rute.	Fortsæt med at stemme.
`processing`	Downloading, remuxing eller sammenlægning.	Vis server fremskridt.
`ready`	Signeret download er tilgængelig.	Send URL-adressen til brugeren.
`failed`	Terminal struktureret fejl.	Læs `error_code`. Prøv kun igen, når det anbefales.
`expired`	Midlertidig output blev fjernet.	Opret et nyt job.

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

SaveTK håndterer Job polling ved først at identificere et sekunds indledende ventetid. Det følger med capped backoff og holder midlertidig underskrevet levering i syne.

Forudsigelige fejl

Fejl kontrakt starter med en ikke-2xx kuvert på SaveTK. Den næste visning dækker en supportanmodning ID. Siden holder forudsigelig klient håndtering synlige.

{
  "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 utilgængeligt format.	Ret anmodningen. Prøv igen for formater.
401	Manglende, ugyldig, udløbet eller forkert områdenøgle.	Kontroller legitimationsoplysningerne på serversiden.
403	Lejer- eller kildepolitikken afviste anmodningen.	Omgå ikke politikken. Kontakt support.
404	Ukendt eller udløbet job.	Opret eventuelt et nyt job.
429	Grænsen for anmodninger eller aktive job er nået.	Ære `retry_after_seconds`.
503	Kø/kapacitet eller opstrøm midlertidigt utilgængelig.	Prøv igen med eksponentiel tilbagefald og jitter.

Driftskontrakt

SaveTK indstiller tilladelser til skaberen-arbejdsgang efter undersøgelse af forventet trafik og udgivelsesplatformene i omfang.

Brug idempotent programlogik, og start aldrig dublerede job for det samme brugerklik.
Cache løse metadata kortvarigt, men altid behandle underskrevne download URL'er som udløber.
Brug begrænset eksponentiel tilbagetrækning med jitter for 429, 503 og genforsøgbare fejl.
Behandl kun offentlige medier eller medier, du har tilladelse til at få adgang til. DRM og adgangskontroller omgås ikke.
Behold anmodnings-ID'er og job-ID'er i private driftslogfiler. Log ikke indsendte URL'er unødvendigt.

SaveTK præsenterer tre praktiske punkter for Schema-adgang. Først kommer aktivering før udforskning. Gemmearbejdsgangen dækker derefter tildelt autentificering. Det sidste punkt er dokumenterede anmodningsformer.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Angiv hvad SaveTK klienten gør, hvor mange kald den forventer, og hvilke posttjenester der er essentielle. Supportgennemgangen vælger sine omfang, og returnerer derefter en ikke-genoprettelig legitimationsoplysning vist én gang.

Anmod om aktivering Nøgler er lejerafgrænsede, kan tilbagekaldes og udstedes via kontaktformularen. Anonyme scripts kan ikke udføre downloaderarbejde.