REST API Produksi · v1

Bangun undhuhan nganggo YTSave

Tanggulangi URL media umum, pilih format sing tepat, gawe tugas asinkron lan serahake asil sing wis ditandatangani marang pangguna sampeyan. Jalur produksi sing padha sing diwatesi iki nyokong situs web YTSave.

YTSaveClientJSON liwat HTTPSPekerjaan AsinkronKredensial sing diwatesi

Miwiwiti cepet

YTSave ngatur host API kanthi ngenali kredensial sing diaktifake dhukungan dhisik. Banjur ngetutake titik pungkasan penyewa sing ditugasake lan njaga jalur panggilan mung server supaya katon.

URL panyewahttps://ytsave.app

AutentikasiX-API-Key: ys_live_…

Profil klienYTSaveClient

Versi APIv1

# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"

curl -X POST https://ytsave.app/v1/resolve \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Kanggo nerangake keamanan Kredensial, YTSave misahake panyimpen rahasia sisih server saka ora ana bundel klien sing disisipake. Cathetan bukti ora menehi log umum utawa repositori papan dhewe.

Ngatasi pranala

YTSave nangani operasi Resolve kanthi ngenali deteksi sumber dhisik. Banjur ngetutake format saka siji URL sing diajukake lan ora nyimpen output sing digawe ing tampilan.

POST/v1/resolveLingkup: ngrampungake

Lapangan	Jinis	Dibutuhake	Katrangan
`url`	URL HTTPS	Ya	Kaca media umum utawa sing sah kanggo dianalisis.
`tenant`	string	Ora	Domain panyewa sing ditugasake. Biasane ora kalebu.

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

Kanggo nerangake identifier Format, YTSave misahake nilai sing bali tanpa owah saka kasedhiyan saben pranala. Rekaman bukti ora menehi label kualitas sing ditebak papan dhewe.

Gawé lan tindakna tugas undhuhan

Kanggo nggawe Job, YTSave miwiti kanthi persiapan asinkron. Cathetan bukti kasebut dipasangake karo panjalukan HTTP sing cekak lan rampung kanthi eksekusi pekerja sing diwatesi.

POST/v1/jobsLingkup: pakaryan

Lapangan	Jinis	Dibutuhake	Katrangan
`url`	URL HTTPS	Ya	Sumber normalisasi sing padha diajukake kanggo ngrampungake.
`format_id`	string	Ya	ID persis saka tanggapan resolve.
`tenant`	string	Ora	Domain panyewa sing ditugasake. Biasane ora kalebu.

curl -X POST https://ytsave.app/v1/jobs \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'

1202 DitampaSimpen job_id.

2Status jajak pendapatGET /v1/jobs/{job_id} kanthi tombol sing padha.

3SiapBukak URL download sing wis ditandatangani.

Status	Tegese	Tindakan klien
`queued`	Ditampa menyang antrian winates.	Survei maneh kanthi mundur.
`extracting`	Nganyari metadata sumber utawa rute.	Terusake polling.
`processing`	Ngundhuh, remuxing utawa nggabung.	Tampilake kemajuan server.
`ready`	Download sing wis ditandatangani kasedhiya.	Kirim URL menyang pangguna.
`failed`	Kesalahan struktur terminal.	Waca `error_code`. Coba maneh mung nalika disaranake.
`expired`	Output sementara wis dibusak.	Gawe pakaryan anyar.

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave nggawe polling Job gampang dipindai. Kaca diwiwiti kanthi ngenteni siji detik, pindhah menyang backoff sing diwatesi, lan kanthi cetha nyatakake pangiriman sing ditandatangani sementara.

Kesalahan sing bisa diprediksi

Kanggo kontrak Kesalahan, YTSave mriksa siji amplop non-2xx sadurunge ID panjaluk dhukungan. Cathetan bukti iki uga nggawe penanganan klien sing bisa diprediksi dadi cetha.

{
  "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	Tegese umum	Aksi
400	URL ora sah, isi utawa format ora kasedhiya.	Benerake panjalukan. Coba maneh kanggo format.
401	Kunci ilang, ora sah, kadaluwarsa utawa kunci kanthi cakupan salah.	Priksa kredensial sisih server.
403	Kebijakan panyewa utawa sumber nolak panjalukan.	Aja ngliwati kebijakan. Hubungi dhukungan.
404	Pakaryan ora dingerteni utawa wis kadaluwarsa.	Gawe tugas anyar yen cocog.
429	Watesan panjalukan utawa tugas aktif wis tekan.	Pakurmatan `retry_after_seconds`.
503	Antrean/kapasitas utawa aliran munggah sementara ora kasedhiya.	Coba maneh nganggo backoff eksponensial lan jitter.

Kontrak operasional

YTSave menehi kuota operasional saben persetujuan kanggo nglindhungi konsumen API lan layanan media upstream.

Gunakake logika aplikasi idempoten lan aja miwiti tugas duplikat kanggo klik pangguna sing padha.
Cache metadata resolusi kanthi cepet, nanging tansah anggep URL undhuhan sing wis ditandatangani minangka kadaluwarsa.
Gunakake bounded exponential backoff kanthi jitter kanggo 429, 503 lan kesalahan sing bisa dicoba maneh.
Proses mung media umum utawa media sing sampeyan duwe wewenang kanggo ngakses. DRM lan kontrol akses ora bisa dilangkahi.
Tetepake ID panjaluk lan ID tugas ing log operasional pribadi. Aja log URL sing dikirim tanpa perlu.

YTSave ngatur akses Skema kanthi ngenali aktivasi dhisik sadurunge eksplorasi. Iki ngetutake otentikasi sing wis ditugasake lan njaga bentuk panjalukan sing didokumentasikake supaya tetep katon. Referensi OpenAPI

AKSES DIPERIKSA OPERATOR

Jaluk kunci API panjenengan

Dokumentasikake konsumen API, perkiraan panjalukan saben wulan lan syarat platform sing didhukung. YTSave mriksa apa resolve, pengajuan tugas utawa loro-lorone pantes sadurunge ngeluarke kunci sing tau katon.

Nyuwun akses API Kunci iku diwatesi kanggo penyewa, bisa dibatalake lan diterbitake liwat formulir Kontak. Skrip anonim ora bisa nindakake tugas downloader.