Numai previzualizare — activare necesară

Construiți descărcări cu SaveTK

SaveTK afișează un plan API pentru integrările cu instrumente pentru creatori, dar nu acceptă execuție neautentificată. Aprobarea furnizează atât cheia, cât și limitele sale de funcționare.

SaveTkCreatorJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu

Start rapid

SaveTK prezintă trei puncte practice pentru gazda API. Primul este reprezentat de acreditările activate de suport. Fluxul de salvare acoperă apoi un punct final de tenant atribuit. Ultimul punct este o cale de apel doar pentru server.

URL- ul entității găzduitehttps://savetk.app

AutentificareX-API-Key: pending_activation_…

Profilul de clientSaveTkCreator

Versiune 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 face ca siguranța acreditărilor să fie ușor de verificat. Pagina începe cu stocarea secretelor pe partea de server, continuă cu absența încorporării în bundle-ul client și afirmă clar că nu există jurnale publice sau depozite publice.

Rezolvarea unui link

SaveTK prezintă trei puncte practice pentru utilizarea lui Resolve. Mai întâi vine detectarea sursei. Fluxul de salvare acoperă apoi formate dintr-un singur URL trimis. Ultimul punct este că nu există ieșiri inventate.

POST/v1/resolveScop: rezolva

Câmp	Tip	Obligatoriu	Descrierea
`creator_link`	URL HTTPS	Da.	Pagina media publică sau autorizată pentru a analiza.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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

SaveTK face identificatorul de format ușor de scanat. Pagina începe cu valoarea returnată neschimbată, trece la disponibilitatea pentru fiecare link în parte și precizează clar că nu există o etichetă de calitate ghicită.

Crearea și urmărirea unei lucrări de descărcare

Crearea jobului începe cu pregătirea asincronă pe SaveTK. Acest flux de lucru de salvare prezintă apoi o scurtă solicitare HTTP. Faptul final este execuția delimitată a lucrătorului.

POST/v1/jobsDomeniul de aplicare: locuri de muncă

Câmp	Tip	Obligatoriu	Descrierea
`creator_link`	URL HTTPS	Da.	Aceeași sursă normalizată prezentată pentru a rezolva.
`save_option`	șir	Da.	Un ID exact din răspunsul de rezolvare.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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 AcceptatSalvează save_task.

2Starea sondajuluiGET /v1/jobs/{save_task} cu aceeași cheie.

3Gata.Deschideți URL-ul de descărcare semnat.

Starea	Semnificație	Acțiune de client
`queued`	Admis în coada limitată.	Sondaj din nou cu backoff.
`extracting`	Reîmprospătarea metadatelor sursă sau a rutei.	Continuă să votezi.
`processing`	Descărcarea, remixarea sau îmbinarea.	Afișați progresul serverului.
`ready`	Descărcarea semnată este disponibilă.	Trimiteți URL-ul utilizatorului.
`failed`	Eroare structurată terminală.	Citiți `error_code`. Reîncercaţi numai atunci când este recomandat.
`expired`	Ieșirea temporară a fost eliminată.	Creați un loc de muncă nou.

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

SaveTK gestionează sondarea Job prin identificarea mai întâi a unei așteptări inițiale de o secundă. Continuă cu o creștere exponențială limitată și păstrează în vedere livrarea temporară semnată.

Erori previzibile

Contractul de eroare începe cu un singur plic non-2xx pe SaveTK. Următoarea vizualizare acoperă un ID de solicitare de asistență. Pagina păstrează vizibilă gestionarea clientului previzibilă.

{
  "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	Semnificație tipică	Acțiune
400	URL nevalid, corp sau format indisponibil.	Corectați solicitarea. Rezolvați din nou pentru formate.
401	Cheie lipsă, nevalidă, expirată sau cu domeniu incorect.	Verificați acreditările de pe partea serverului.
403	Politica chiriașului sau a sursei a respins solicitarea.	Nu ocoliți politica. Contactați asistența.
404	Loc de muncă necunoscut sau expirat.	Creați un nou loc de muncă, dacă este cazul.
429	A fost atinsă limita de solicitări sau de lucrări active.	Onoare. `retry_after_seconds`.
503	Coada/capacitatea sau sursa din amonte sunt temporar indisponibile.	Reîncercați cu backoff exponențial și jitter.

Contract de exploatare

SaveTK stabilește permisiunile fluxului de lucru al creatorului după examinarea traficului estimat și a platformelor de publicare din domeniu.

Folosiți logică de aplicație idempotentă și nu porniți niciodată joburi duplicate pentru același clic al utilizatorului.
Stocați temporar metadatele rezolvate în cache, dar tratați întotdeauna URL-urile semnate de descărcare ca expirabile.
Utilizați backoff exponențial limitat cu jitter pentru 429, 503 şi erori reîncercabile.
Procesează doar media publică sau media la care ești autorizat să ai acces. DRM și controalele de acces nu sunt ocolite.
Păstrați ID-urile cererilor și ID-urile joburilor în jurnalele operaționale private. Nu înregistrați inutil URL-urile trimise.

SaveTK prezintă trei puncte practice pentru accesul la Schema. Primul este activarea înainte de explorare. Fluxul de salvare acoperă apoi autentificarea atribuită. Ultimul punct este reprezentat de formele documentate ale cererilor.

ACCES REVIZUIT DE OPERATOR

Activați prin asistență

Spune ce face clientul SaveTK, câte apeluri așteaptă și ce servicii de postare sunt esențiale. Evaluarea suportului își selectează domeniile, apoi returnează o acreditare nerecuperabilă afișată o singură dată.

Solicitați activarea Cheile sunt limitate la nivel de chiriaș, pot fi revocate și sunt emise prin formularul de contact. Scripturile anonime nu pot executa sarcini de descărcare.