Ngan ukur preview — aktivasina diperyogikeun

Ngawangun unduhan nganggo SaveTK

SaveTK nembongkeun rencana API pikeun integrasi alat-pangripta, tapi henteu nampi éksekusi tanpa otentikasi. Persetujuan nyayogikeun boh konci boh wates operasi na.

SaveTkCreatorJSON ngalangkungan HTTPSPakaryan asinkronKredensial anu diwatesan

Mimitian gancang

SaveTK nampilkeun tilu titik praktis pikeun host API. Anu kahiji nyaéta kredensial anu diaktipkeun ku dukungan. Alur nyimpen teras ngaliput titik akhir tenant anu ditugaskeun. Titik ahirna nyaéta jalur telepon khusus server.

URL panyewahttps://savetk.app

AuténtikasiX-API-Key: pending_activation_…

Profil klienSaveTkCreator

Versi 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 ngajantenkeun kaamanan Kredensial gampang dipindai. Halaman dimimitian ku panyimpenan rusiah sisi server, ngalih ka teu aya bundel klien anu diselapkeun, sareng sacara jelas nyatakeun teu aya log umum atanapi répositori.

Ngarengsekeun hiji link

SaveTK nampilkeun tilu titik praktis pikeun operasi Resolve. Anu kahiji nyaéta deteksi sumber. Alur kerja nyimpen teras ngaliput format tina hiji URL anu dikintunkeun. Titik ahirna nyaéta teu aya hasil anu didamel.

POST/v1/resolveLingkup: ngarengsekeun

Medan	Tipe	Diperyogikeun	Katerangan
`creator_link`	URL HTTPS	Leres	Halaman média umum atanapi anu diidinan pikeun dianalisis.
`tenant`	string	Henteu	Ditugaskeun domain panyewa. Biasana dileungitkeun.

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

SaveTK ngajadikeun Identifier Format gampang dipindai. Halaman dimimitian ku nilai anu dipulangkeun tanpa robah, ngalih ka kasadiaan per-link, sarta sacara jelas nyatakeun teu aya labél kualitas anu ditebak.

Nyiptakeun sareng nuturkeun padamelan unduhan

Nyiptakeun pagawéan dimimitian ku persiapan asinkron dina SaveTK. Alur nyimpen ieu teras nampilkeun pamundut HTTP pondok. Fakta ahirna nyaéta palaksanaan pagawé anu diwatesan.

POST/v1/jobsLingkup: padamelan

Medan	Tipe	Diperyogikeun	Katerangan
`creator_link`	URL HTTPS	Leres	Sumber normalisasi anu sami diserahkeun pikeun direngsekeun.
`save_option`	string	Leres	ID anu pasti tina réspon ngarengsekeun.
`tenant`	string	Henteu	Ditugaskeun domain panyewa. Biasana dileungitkeun.

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

2Status pollingGET /v1/jobs/{save_task} kalayan konci anu sami.

3SiapBuka URL unduhan anu ditandatanganan.

Status	Harti	Tindakan klien
`queued`	Ditampi kana antrian anu diwatesan.	Poll deui sareng backoff.
`extracting`	Ngarefresh metadata sumber atanapi rute.	Teruskeun polling.
`processing`	Ngaunduh, remuxing atanapi ngahijikeun.	Tampilan kamajuan server.
`ready`	Unduh anu ditandatanganan sayogi.	Kirimkeun URL ka pangguna.
`failed`	Kasalahan struktur terminal.	Baca `error_code`. Coba deui ngan ukur nalika disarankeun.
`expired`	Kaluaran samentawis dipiceun.	Nyiptakeun padamelan anyar.

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

SaveTK ngatur polling Pagawean ku mimiti ngaidentipikasi antosan awal salila hiji detik. Teras nuturkeun backoff anu diwatesan sareng ngajaga pangiriman ditandatanganan samentawis dina pandangan.

Kasalahan anu tiasa diprediksi

Kasalahan kontrak dimimitian ku hiji amplop non-2xx dina SaveTK. Tampilan salajengna nutupan ID pamundut dukungan. Halaman tetep nunjukkeun pangaturan klien anu tiasa diprediksi.

{
  "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	Harti anu khas	Aksi
400	URL anu henteu valid, awak atanapi format anu teu aya.	Ngabenerkeun pamundut. Ngarengsekeun deui pikeun format.
401	Konci leungit, henteu valid, kadaluarsa atanapi salah-ruang lingkup.	Pariksa kredensial sisi server.
403	Panyewa atanapi kabijakan sumber nolak pamundut.	Ulah bypass kawijakan. Hubungi rojongan.
404	Pakaryan anu teu dikenal atanapi kadaluarsana.	Nyiptakeun padamelan énggal upami cocog.
429	Kéngingkeun atanapi aktip-pakaryan wates ngahontal.	Honor `retry_after_seconds`.
503	Antrian/kapasitas atawa upstream keur teu aya samentara.	Coba deui sareng backoff éksponénsial sareng jitter.

Kontrak operasi

SaveTK nyetél kreator-alur kerja tunjangan saatos nalungtik lalu lintas anu diarepkeun sareng platform posting dina lingkup.

Anggo logika aplikasi idempotent sareng henteu kantos ngamimitian padamelan duplikat pikeun pangguna anu sami klik.
Cache metadata résolusi sacara singget, tapi sok anggap URL unduhan anu ditandatanganan salaku kadaluwarsa.
Anggo backoff éksponénsial anu dibatesan sareng jitter pikeun 429, 503 sareng kasalahan anu tiasa diusahakeun deui.
Ngolah ngan ukur média umum atanapi média anu anjeun diidinan pikeun ngaksés. DRM sareng kontrol aksés henteu dipaliré.
Ngajaga ID pamundut sareng ID padamelan dina log operasi pribadi. Ulah log URL anu dikirimkeun tanpa perlu.

SaveTK nampilkeun tilu titik praktis pikeun aksés Skéma. Anu kahiji nyaéta aktivasina saméméh éksplorasi. Alur nyimpen teras nutupan oténtikasi anu ditugaskeun. Titik ahirna nyaéta bentuk paménta anu didokumentasikeun.

AKSES DIPANGKEUN OPERATOR

Aktipkeun ngalangkungan dukungan

Jelaskeun naon anu dilakukeun ku klien SaveTK, sabaraha telepon anu dipiharep sareng jasa pos mana anu penting. Tinjauan dukungan milih lingkupna, teras ngabalikeun kredensial anu teu tiasa dipulihkeun anu dipidangkeun sakali wungkul.

Kéngingkeun aktivasina Konci téh diwatesan ku panyewa, bisa dibatalkeun jeung dikaluarkeun ngaliwatan formulir Kontak. Skrip anonim teu bisa ngalaksanakeun pagawéan pangunduh.