Pratinjau saja — aktivasi diperlukan

Bangun unduhan dengan Social Video Saver

SocialVideoSaver menyediakan skema lintas-jaringan ini untuk perencanaan teknis. Kredensial produksi tetap nonaktif sampai kasus penggunaan yang diusulkan melewati tinjauan dukungan.

SocialSaverWorkspaceJSON melalui HTTPSTugas asinkronKredensial yang dijangkau

Awal yang cepat

Dukungan-kredibilitas yang diaktifkan adalah titik awal untuk host API di SocialVideoSaver. Tampilan multi-sumber kemudian menyajikan titik akhir tenant yang ditugaskan dan menjelaskan jalur panggilan hanya server.

URL Tenanthttps://socialvideosaver.com

OtentikasiX-API-Key: pending_activation_…

Profil klienSocialSaverWorkspace

Versi APIv1

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

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

Tampilan multi-sumber SocialVideoSaver meninjau penyimpanan rahasia sisi server untuk keamanan Credential. Ini menunjukkan tidak ada bundle klien yang dimasukkan berikutnya dan tidak menutupi tidak ada log publik atau repositori.

Menyelesaikan sebuah tautan

Deteksi sumber adalah titik awal untuk operasi Resolve pada SocialVideoSaver. Tampilan multi-sumber kemudian menyajikan format dari satu URL yang diajukan dan menjelaskan tidak ada keluaran yang diciptakan.

POST/v1/resolveScope: menyelesaikan

Medan	Jenis	Diperlukan	Deskripsi
`social_url`	URL HTTPS	Ya	Halaman media publik atau resmi untuk dianalisis.
`tenant`	string	Tidak.	Domain penyewa yang ditetapkan. Biasanya dihilangkan.

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

Tampilan multi-sumber SocialVideoSaver meninjau nilai yang dikembalikan tidak berubah untuk pengenal Format. Ini menunjukkan ketersediaan per-link berikutnya dan tidak menutupi tidak ada label kualitas yang ditebak.

Buat dan ikuti pekerjaan unduhan

SocialVideoSaver mendekati pembuatan Pekerjaan melalui persiapan asinkron, kemudian permintaan HTTP singkat. Tampilan multi-sumber menjaga eksekusi pekerja terbatas secara eksplisit.

POST/v1/jobsLingkup: pekerjaan

Medan	Jenis	Diperlukan	Deskripsi
`social_url`	URL HTTPS	Ya	Sumber yang dinormalisasi sama diajukan untuk diselesaikan.
`media_profile`	string	Ya	ID tepat dari respons penyelesaian.
`tenant`	string	Tidak.	Domain penyewa yang ditetapkan. Biasanya dihilangkan.

curl -X POST https://socialvideosaver.com/v1/jobs \
  -H "X-API-Key: $SVS_WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID","media_profile":"18"}'

1202 DiterimaSimpan delivery_job.

2Status PollGET /v1/jobs/{delivery_job} dengan kunci yang sama.

3SiapBuka URL unduhan yang ditandatangani.

Status	Artinya	Tindakan klien
`queued`	Diterima ke antrian terbatas.	Poll lagi dengan backoff.
`extracting`	Menyegarkan metadata sumber atau rute.	Lanjutkan polling.
`processing`	Mengunduh, meremux, atau menggabungkan.	Tunjukkan kemajuan server.
`ready`	Unduh yang ditandatangani tersedia.	Kirim URL ke pengguna.
`failed`	Kesalahan struktur terminal.	Baca `error_code`. Coba ulang hanya ketika dianjurkan.
`expired`	Keluaran sementara dihapus.	Buat pekerjaan baru.

curl https://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
  -H "X-API-Key: $SVS_WORKSPACE_KEY"

SocialVideoSaver mengatur polling Pekerjaan dengan jeda awal satu detik. Tampilan multi-sumbernya membandingkan pembatasan backoff. Pengiriman bertanda sementara tetap menjadi pemeriksaan akhir.

Kesalahan yang dapat diprediksi

Dalam SocialVideoSaver, satu amplop non-2xx datang pertama kali saat menjelaskan Kontrak Error. Pandangan multi-sumber itu mengikuti dengan ID permintaan dukungan dan menutup pada penanganan klien yang dapat 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	Arti yang khas	Action
400	URL tidak valid, isi atau format tidak tersedia.	Perbaiki permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak valid, kedaluwarsa, atau cakupan salah.	Periksa kredensial sisi server.
403	Kebijakan penyewa atau sumber menolak permintaan.	Jangan melewati kebijakan. Hubungi dukungan.
404	Pekerjaan yang tidak diketahui atau kadaluarsa.	Buat pekerjaan baru jika sesuai.
429	Batas permintaan atau pekerjaan aktif telah tercapai.	Kehormatan `retry_after_seconds`.
503	Antrian/kapasitas atau hulu sementara tidak tersedia.	Coba lagi dengan penundaan eksponensial dan jitter.

Kontrak operasional

SocialVideoSaver meninjau proyeksi permintaan lintas jaringan sebelum menetapkan batas pada integrasi yang disetujui.

Gunakan logika aplikasi idempotent dan jangan pernah memulai pekerjaan duplikat untuk klik pengguna yang sama.
Cache menyelesaikan metadata secara singkat, tetapi selalu memperlakukan URL unduhan yang ditandatangani sebagai berakhir.
Gunakan bounded exponential backoff dengan jitter untuk 429, 503 dan kesalahan yang dapat dicoba kembali.
Proses hanya media publik atau media yang Anda diizinkan untuk mengakses. DRM dan kontrol akses tidak dihindari.
Simpan ID permintaan dan ID pekerjaan dalam log operasional pribadi. Jangan log URL yang diajukan tanpa perlu.

Aktivasi sebelum eksplorasi adalah titik awal untuk akses Schema di SocialVideoSaver. Tampilan multi-sumber kemudian menyajikan otentikasi yang ditugaskan dan menjelaskan bentuk permintaan yang terdokumentasi.

AKSESS YANG DIPERIKSA OPERATO

Aktifkan melalui dukungan

Ringkas produk lintas jaringan, proyeksi permintaan bulanan, dan setiap penyedia sosial dalam cakupan. SocialVideoSaver hanya mengaktifkan analisis atau kemampuan pekerjaan yang diminta dan menyimpan hash sebagai pengganti token.

Minta aktivasi Kunci adalah tenant-scoped, dapat dicabut dan dikeluarkan melalui formulir Kontak. Skrip anonim tidak dapat menjalankan pekerjaan pengunduh.