Pralihat sahaja — pengaktifan diperlukan

Bina muat turun dengan Social Video Saver

SocialVideoSaver menyediakan skema lintas rangkaian ini untuk perancangan teknikal. Kredibiliti pengeluaran kekal dimatikan sehingga kes penggunaan yang dicadangkan lulus semakan sokongan.

SocialSaverWorkspaceJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan

Mulakan dengan cepat

Sokongan-diaktifkan kelayakan adalah titik permulaan untuk tuan rumah API pada SocialVideoSaver. Pandangan berbilang sumber kemudian membentangkan titik akhir penyewa yang ditugaskan dan menerangkan laluan panggilan pelayan sahaja.

URL Penyewahttps://socialvideosaver.com

PengesahanX-API-Key: pending_activation_…

Profil PelangganSocialSaverWorkspace

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"}'

Pandangan pelbagai sumber SocialVideoSaver mengkaji semula penyimpanan rahsia sisi pelayan untuk keselamatan Credential. Ia menunjukkan tiada bundle klien yang dimasukkan seterusnya dan tidak menutupi tiada log awam atau repositori.

Menyelesaikan pautan

Pengesanan sumber adalah titik permulaan untuk operasi Resolve pada SocialVideoSaver. Pandangan pelbagai sumber kemudian membentangkan format dari satu URL yang dikemukakan dan menjelaskan tiada output yang dicipta.

POST/v1/resolveSkop: menyelesaikan

Medan	Jenis	Diperlukan	Huraian
`social_url`	URL HTTPS	Ya	Halaman media awam atau yang dibenarkan untuk dianalisis.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

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

Pandangan berbilang sumber SocialVideoSaver mengkaji semula nilai yang dikembalikan tidak berubah untuk pengenal Format. Ia menunjukkan ketersediaan per pautan seterusnya dan tidak menutupi tiada label kualiti yang ditebak.

Cipta dan ikuti kerja muat turun

SocialVideoSaver mendekati Penciptaan Kerja melalui persediaan asinkron, kemudian permintaan HTTP pendek. Pandangan berbilang sumber menyimpan pelaksanaan pekerja yang dibatasi secara eksplisit.

POST/v1/jobsSkop: pekerjaan

Medan	Jenis	Diperlukan	Huraian
`social_url`	URL HTTPS	Ya	Sumber yang sama dinormalisasi dihantar untuk menyelesaikan.
`media_profile`	rentetan	Ya	ID yang tepat dari respons penyelesaian.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

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 undianGET /v1/jobs/{delivery_job} dengan kunci yang sama.

3SediaBuka URL muat turun yang ditandatangani.

Status	Makna	Tindakan Pelanggan
`queued`	Dibenarkan masuk ke barisan yang dibatasi.	Poll lagi dengan backoff.
`extracting`	Menyegar semula metadata sumber atau laluan.	Teruskan mengundi.
`processing`	Memuat turun, remuxing atau menggabungkan.	Papar kemajuan pelayan.
`ready`	Muat turun yang ditandatangani tersedia.	Hantar URL kepada pengguna.
`failed`	Ralat berstruktur terminal.	Baca `error_code`. Cuba semula hanya apabila dinasihatkan.
`expired`	Keluaran sementara dikeluarkan.	Cipta pekerjaan baru.

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

SocialVideoSaver mengatur polling Kerja sekitar satu-detik awal menunggu. pandangan berbilang sumbernya membandingkan backoff capped. penghantaran sementara yang ditandatangani kekal pemeriksaan akhir.

Kesalahan yang boleh diramalkan

Dalam SocialVideoSaver, satu sampul surat bukan 2xx datang terlebih dahulu apabila menerangkan Kontrak ralat. Pandangan berbilang sumber itu mengikuti dengan ID permintaan sokongan dan ditutup pada pengendalian pelanggan yang dapat diramalkan.

{
  "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	Tindakan
400	URL tidak sah, badan atau format tidak tersedia.	Betulkan permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak sah, tamat tempoh atau salah skop.	Semak kelayakan sisi pelayan.
403	Polisi penyewa atau sumber menolak permintaan.	Jangan mengelirukan dasar Hubungi sokongan.
404	Kerja yang tidak diketahui atau tamat tempoh.	Buat kerja baru jika sesuai.
429	Permintaan atau had aktif-kerja telah dicapai.	Kehormatan `retry_after_seconds`.
503	Baris gilir/kapasiti atau upstream tidak tersedia buat sementara waktu.	Cuba lagi dengan backoff eksponen dan jitter.

Kontrak operasi

SocialVideoSaver mengkaji permintaan silang rangkaian yang diramalkan sebelum menetapkan had kepada integrasi yang diluluskan.

Gunakan logik aplikasi idempotent dan jangan pernah memulakan kerja berganda untuk klik pengguna yang sama.
Cache menyelesaikan metadata secara ringkas, tetapi sentiasa merawat URL muat turun yang ditandatangani sebagai tamat tempoh.
Gunakan backoff eksponen yang dibatasi dengan jitter untuk 429, 503 dan kesilapan yang boleh dicuba semula.
Proses hanya media awam atau media yang anda dibenarkan untuk mengakses. DRM dan kawalan akses tidak dipintas.
Simpan ID permintaan dan ID kerja dalam log operasi peribadi. Jangan log URL yang dihantar tanpa perlu.

Pengaktifan sebelum penerokaan adalah titik permulaan untuk akses Schema pada SocialVideoSaver. Pandangan pelbagai sumber kemudian membentangkan pengesahan yang ditugaskan dan menerangkan bentuk permintaan yang didokumentasikan.

AKSESS YANG DIPERIKSA OPERASI

Aktifkan melalui sokongan

Ringkasan produk silang rangkaian, permintaan bulanan yang diramalkan dan setiap penyedia sosial dalam skop. SocialVideoSaver mengaktifkan hanya analisis yang diminta atau keupayaan kerja dan menyimpan hash bukannya token.

Minta pengaktifan Kunci adalah skop penyewa, boleh dibatalkan dan dikeluarkan melalui borang Hubungi. Skrip tanpa nama tidak dapat melaksanakan kerja pemuat turun.