REST API PRODUKSI · v1

Bangun unduhan dengan YTSave

Selesaikan URL media publik, pilih format yang tepat, buat pekerjaan asinkron, dan serahkan hasil yang ditandatangani ke pengguna Anda. Jalur produksi terbatas yang sama menggerakkan website YTSave.

YTSaveClientJSON lewat HTTPSPekerjaan AsinkronKredensial terbatas

Mulai cepat

YTSave menangani host API dengan pertama-tama mengidentifikasi kredensial yang diaktifkan dukungan. Ini diikuti dengan titik akhir penyewa yang ditugaskan dan menjaga jalur panggilan hanya server tetap terlihat.

Url penyewahttps://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"}'

Untuk menjelaskan keamanan Kredensial, YTSave memisahkan penyimpanan rahasia sisi server dari tanpa penyematan bundel klien. Rekor bukti tidak memberikan log publik atau repositori tempat sendiri.

Selesaikan tautan

YTSave mappisengngi operasi Resolve dengan mappasengngi deteksi sumber dulu. Mappasengngi format dari satu URL yang dikirim dan tidak menyimpan output yang dibuat-buat.

KIRIM/v1/resolveLingkup: selesaikan

Ladang	Jenis	Dibutuhkan	Deskripsi
`url`	URL HTTPS	Iyya	Halaman media publik atau resmi untuk dianalisis.
`tenant`	string	Tada	Domain penyewa yang ditugaskan. Biasanya dihilangkan.

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

Untuk menjelaskan pengenal Format, YTSave memisahkan nilai yang dikembalikan tanpa perubahan dari ketersediaan per tautan. Rekor bukti tidak memberikan label kualitas tebakannya tempat sendiri.

Buat na ikuti pekerjaan download

Untuk pembuatan Pekerjaan, YTSave mulai dengan persiapan asinkron. Catatan bukti menggabungkan itu dengan permintaan HTTP singkat dan berakhir dengan eksekusi pekerja terbatas.

KIRIM/v1/jobsLingkup: pekerjaan

Ladang	Jenis	Dibutuhkan	Deskripsi
`url`	URL HTTPS	Iyya	Sumber normalisasi yang sama diserahkan untuk diselesaikan.
`format_id`	string	Iyya	ID tepat dari respons penyelesaian.
`tenant`	string	Tada	Domain penyewa yang ditugaskan. Biasanya dihilangkan.

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 DiterimaSimpan job_id.

2Status pollingGET /v1/jobs/{job_id} dengan kunci yang sama.

3SiapBuka URL unduhan yang ditandatangani.

Status	Maknâ	Tindakan klien
`queued`	Diterima ke antrean terbatas.	Pilih lagi dengan penundaan.
`extracting`	Mappasengngi metadata sumber atau rute.	Lanjutang polling.
`processing`	Mendownload, remuxing atawa menggabungkan.	Tampilkan kemajuan server.
`ready`	Unduhan yang ditandatangani tersedia.	Kirim URL ri pangngulu.
`failed`	Kesalahan terstruktur terminal.	Baca `error_code`. Coba ulangi iyaro anjuran.
`expired`	Keluaran sementara dihapus.	Buat pekerjaan baru.

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

YTSave memudahkan pemindaian pemantauan Pekerjaan. Halaman dimulai dengan tunggu awal satu detik, beralih ke penundaan terbatas, dan dengan jelas menyatakan pengiriman bertanda sementara.

Kesalahan yang dapat diprediksi

Untuk kontrak Kesalahan, YTSave memeriksa satu amplop non-2xx sebelum ID permintaan dukungan. Rekaman bukti ini juga membuat penanganan klien yang dapat diprediksi menjadi jelas.

{
  "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	Makna biasa	Aksi
400	URL, badan, atau format yang tidak tersedia tidak valid.	Betulangi permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak valid, kedaluwarsa, atau dengan cakupan salah.	Periksa kredensial sisi server.
403	Kebijakan penyewa atau sumber menolak permintaan.	Iye'na mappasila' kebijakan. Kontaki dukungan.
404	Pekerjaan tidak dikenal atau kedaluwarsa.	Buat pekerjaan baru jika sesuai.
429	Batas permintaan atau pekerjaan aktif telah tercapai.	Hormati `retry_after_seconds`.
503	Antrian/kapasitas atau hulu sementara tidak tersedia.	Coba ulangi dengan penundaan eksponensial dan jitter.

Kontrak operasional

YTSave mengeluarkan kuota operasional dengan setiap persetujuan untuk melindungi konsumen API dan layanan media hulu.

Gunakan logika aplikasi idempoten dan jangan pernah memulai pekerjaan duplikat untuk klik pengguna yang sama.
Simpan metadata penyelesaian dalam cache sebentar, tetapi selalu perlakukan URL unduhan bertanda sebagai yang kedaluwarsa.
Gunakan penundaan eksponensial terbatas dengan jitter untuk 429, 503 dan kesalahan yang bisa dicoba ulang.
Proses hanya media publik atau media yang Anda berwenang untuk akses. DRM dan kontrol akses tidak dilewati.
Jaga ID permintaan dan ID pekerjaan dalam log operasional pribadi. Jangan mencatat URL yang dikirimkan secara tidak perlu.

YTSave menangani akses Skema dengan terlebih dahulu mengidentifikasi aktivasi sebelum eksplorasi. Ini diikuti dengan autentikasi yang ditugaskan dan menyimpan bentuk permintaan yang didokumentasikan dalam tampilan. Referensi OpenAPI

AKSES YANG DIPERIKSA OPERATOR

Minta kunci API Anda

Dokumentasikan konsumen API, perkiraan permintaan bulanan, dan persyaratan platform yang didukung. YTSave meninjau apakah penyelesaian, pengajuan pekerjaan, atau keduanya dibenarkan sebelum mengeluarkan kunci yang hanya terlihat sekali.

Minta akses API Kunci bersifat tenant-scoped, dapat dicabut, dan diterbitkan melalui formulir Kontak. Skrip anonim tidak dapat menjalankan pekerjaan downloader.