Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med SaveTK

SaveTK visar en API-plan för integrationsverktyg för skapare, men accepterar inte icke-autentiserad körning. Godkännande tillhandahåller både nyckeln och dess driftgränser.

SaveTkCreatorJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

SaveTK presenterar tre praktiska punkter för API-värd. Först kommer stödaktiverade autentiseringsuppgifter. Sparflödet täcker sedan en tilldelad hyresgästandpunkt. Dess sista punkt är en serverendast samtalsväg.

Webbadress till klienthttps://savetk.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilSaveTkCreator

API-versionv1

# 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 gör det enkelt att skanna säkerheten för referenser. Sidan börjar med serverbaserad hemlig lagring, går vidare till ingen inbäddning av klientpaket och anger tydligt att inga offentliga loggar eller arkiv finns.

Lösa en länk

SaveTK presenterar tre praktiska punkter för Resolve-operationen. Först kommer källidentifiering. Sparflödet täcker sedan format från en inskickad URL. Dess sista punkt är inga påhittade utdata.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`creator_link`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

SaveTK gör formatidentifieraren lätt att skanna. Sidan börjar med det returnerade värdet oförändrat, går vidare till tillgänglighet per länk och anger tydligt att ingen gissad kvalitetsmärkning finns.

Skapa och följ ett nedladdningsjobb

Jobbskapande börjar med asynkron förberedelse på SaveTK. Detta sparande arbetsflöde presenterar sedan en kort HTTP-förfrågan. Det slutgiltiga faktum är begränsad arbetarexekvering.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`creator_link`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`save_option`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara save_task.

2OmröstningsstatusGET /v1/jobs/{save_task} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

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

SaveTK hanterar jobbavfrågning genom att först identifiera en sekunds initial väntetid, följt av en begränsad backoff och håller tillfälligt signerad leverans i sikte.

Förutsägbara fel

Felkontraktet börjar med ett icke-2xx-omslag på SaveTK. Nästa vy täcker en supportförfrågnings-ID. Sidan håller förutsägbar klienthantering 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 betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

SaveTK anger tillåtna mängder för skapararbetsflöden efter att ha undersökt förväntad trafik och publiceringsplattformarna i omfattning.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

SaveTK presenterar tre praktiska punkter för Schema-åtkomst. Först kommer aktivering före utforskning. Sparflödet täcker sedan tilldelad autentisering. Dess sista punkt är dokumenterade förfrågningsformer.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Ange vad SaveTK-klienten gör, hur många anrop den förväntar sig och vilka publiceringstjänster som är väsentliga. Supportgranskningen väljer sina omfattningar, och returnerar sedan en icke-återställbar behörighet som visas en enda gång.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.