PRODUKSI REST API · v1

Bangun unduhan dengan YTSave

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

YTSaveClientJSON lewat HTTPSPekerjaan AsinkronKredensial terbatas

Mula cepat

YTSave mengelola host API dengan terlebih dahulu mengidentifikasi kredensial yang diaktifkan dukungan. Ini diikuti dengan endpoint 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 tidak adanya penyisipan bundel klien. Catatan bukti tidak memberikan log publik atau repositori tempat sendiri.

Selesaikan tautan

YTSave menangani operasi Penyelesaian dengan terlebih dahulu mengidentifikasi deteksi sumber. Ia mengikuti dengan format dari satu URL yang diajukan dan tidak menyimpan keluaran yang dibuat-buat dalam tampilan.

KIRIM/v1/resolveLingkup: selesaikan

Lapangan	Jenis	Diperlukan	Deskripsi
`url`	URL HTTPS	Ie	Halaman media umum atau resmi untuk dianalisis.
`tenant`	string	Teu	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. Catatan bukti tidak memberikan label kualitas tebakannya tempat sendiri.

Buat dan ikuti pekerjaan unduhan

Untuk pembuatan Pekerjaan, YTSave mulai dengan persiapan asinkron. Catatan bukti nyoe meupasang dengan permintaan HTTP singkat dan tamat dengan eksekusi pekerja terbatas.

KIRIM/v1/jobsLingkup: pekerjaan

Lapangan	Jenis	Diperlukan	Deskripsi
`url`	URL HTTPS	Ie	Sumber yang dinormalisasi yang sama diserahkan untuk diselesaikan.
`format_id`	string	Ie	ID tepat dari respons penyelesaian.
`tenant`	string	Teu	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 polingGET /v1/jobs/{job_id} dengan kunci yang sama.

3SiapBuka URL unduhan yang ditandatangani.

Status	Makna	Aksi klien
`queued`	Diterima ke dalam antrean terbatas.	Polling deui kalawan mundur.
`extracting`	Menyegarkan metadata sumber atau rute.	Teruskeun polling.
`processing`	Mengunduh, meremux, atau menggabungkan.	Témbongkeun kamajuan server.
`ready`	Unduhan bertanda tangan tersedia.	Kirim URL ke pengguna.
`failed`	Terminal structured error.	Baca `error_code`. Coba ulang hanya saat disarankan.
`expired`	Keluaran sementara telah dihapus.	Buat pekerjaan baru.

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

YTSave memudahkan pemindaian polling Pekerjaan. Halaman dimulai dengan tunggu awal satu detik, berlanjut 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. Catatan 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 tipikal	Aksi
400	URL tidak valid, isi atau format tidak tersedia.	Perbaiki permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak valid, kadaluwarsa, atau dengan cakupan salah.	Periksa kredensial sisi server.
403	Kebijakan penyewa atau sumber menolak permintaan.	Jangan melewati kebijakan. Hubungi dukungan.
404	Peugah nyoe hana atawa geus kadaluwarsa.	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 ulang 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.
Cache metadata penyelesaian sebentar, tapi selalu anggap URL unduhan bertanda sebagai kedaluwarsa.
Gunakan bounded exponential backoff dengan jitter untuk 429, 503 dengam kesalahan nyang bisa dicoba ulang.
Proses hanya media publik atau media yang Anda berwenang akses. DRM dan kontrol akses tidak dilewati.
Simpan ID permintaan dan ID pekerjaan dalam log operasi pribadi. Jangan catat URL yang dikirim tanpa perlu.

YTSave meunangan akses Schema dengan mula-mula ngenali aktivasi sebelum eksplorasi. Peugah dengan autentikasi yang ditugaskan dan meunyoe dokumen bentuk permintaan dalam pandangan. Referensi OpenAPI

AKSES YANG DIREVIEW 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 pernah terlihat.

Minta akses API Kunci hana tenant-scoped, bisa dibatalin, dan diterbitkan lewat formulir Kontak. Skrip anonim hana bisa menjalankan kerja downloader.