Sadece önizleme — etkinleştirme gerekli

Social Video Saver ile indirme yap

SocialVideoSaver, teknik planlama için bu çapraz ağ şemasını sağlar. Üretim kimlik bilgileri, önerilen kullanım durumu destek incelemesini geçene kadar kapalı kalır.

SocialSaverWorkspaceHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

Destek etkinleştirilmiş kimlik bilgileri, SocialVideoSaver'da API ana bilgisayarı için başlangıç noktasıdır. Çok kaynaklı bir görünüm, atanan bir kiracı uç noktasını sunar ve yalnızca sunucu çağrı yolunu açıklar.

Kiracı URL'sihttps://socialvideosaver.com

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliSocialSaverWorkspace

API sürümüv1

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

SocialVideoSaver'ın çok kaynaklı görünümü, Kimlik Bilgisi güvenliği için sunucu tarafı gizli depolamayı inceler. Sonra hiçbir istemci paketi gömme göstermez ve hiçbir genel günlük veya depo gizlemez.

Bir bağlantıyı çözmek

Kaynak tespiti, SocialVideoSaver'da Çözümleme işleminin başlangıç noktasıdır. Çoklu kaynak görünümü, ardından gönderilen bir URL'den formatları sunar ve uydurulmuş çıktı olmadığını açıklar.

POST/v1/resolveKapsam: çözüm

Alan	Tip	Gerekli	Açıklama
`social_url`	HTTPS URL'si	Evet	Analiz için genel veya yetkili medya sayfası.
`tenant`	dize	Hayır.	Atanmış kiracı alanı. Genellikle atlanır.

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

SocialVideoSaver'ın çoklu kaynak görünümü, Format tanımlayıcı için döndürülen değeri değiştirmeden inceler. Sonra bağlantı başına kullanılabilirliği gösterir ve tahmin edilen kalite etiketini gizlemez.

Bir indirme işi oluştur ve takip et

SocialVideoSaver, İş oluşturmayı eşzamansız hazırlık yoluyla, ardından kısa bir HTTP isteğiyle ele alır. Çok kaynaklı görünüm, sınırlı işçi yürütmesini açık tutar.

POST/v1/jobsKapsam: işler

Alan	Tip	Gerekli	Açıklama
`social_url`	HTTPS URL'si	Evet	Çözümlemek için gönderilen aynı normalize edilmiş kaynak.
`media_profile`	dize	Evet	Çözüm yanıtından tam bir kimlik.
`tenant`	dize	Hayır.	Atanmış kiracı alanı. Genellikle atlanır.

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 Kabul EdildiKaydet delivery_job.

2Anket durumuGET /v1/jobs/{delivery_job} aynı anahtarla.

3Hazırİmzalı indirme URL'sini aç.

Durum	Anlamı	Müşteri işlemi
`queued`	Sınırlı kuyruğa kabul edildi.	Geri çekilerek tekrar anket yap.
`extracting`	Kaynak meta verileri veya rota yenileniyor.	Oylamaya devam edin.
`processing`	İndiriliyor, yeniden paketleniyor veya birleştiriliyor.	Sunucu ilerlemesini göster.
`ready`	İmzalı indirme mevcut.	URL'yi kullanıcıya gönderin.
`failed`	Terminal yapılı hata.	Oku `error_code`Sadece önerildiğinde yeniden deneyin.
`expired`	Geçici çıktı kaldırıldı.	Yeni bir iş oluşturun.

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

SocialVideoSaver, İş anketini bir saniyelik ilk bekleme etrafında organize eder. Çok kaynaklı görünümü, sınırlandırılmış geri çekilmeyi karşılaştırır. Geçici imzalı teslimat son kontrol olarak kalır.

Öngörülebilir hatalar

SocialVideoSaver'da, Hata sözleşmesi açıklanırken önce bir non-2xx zarf gelir. Bu çok kaynaklı görünüm, bir destek talebi kimliği ile devam eder ve öngörülebilir istemci işlemi ile kapanır.

{
  "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	Tipik anlamı	Eylem
400	Geçersiz URL, içerik veya kullanılamayan format.	İsteği düzeltin. Formatlar için tekrar çözün.
401	Eksik, geçersiz, süresi dolmuş veya yanlış kapsamda anahtar.	Sunucu tarafı kimlik bilgilerini kontrol et.
403	Kiracı veya kaynak politikası isteği reddetti.	Politikayı atlamayın. Destek ile iletişime geçin.
404	Bilinmeyen veya süresi dolmuş iş.	Uygunsa yeni bir iş oluşturun.
429	İstek veya aktif iş limiti aşıldı.	Onur `retry_after_seconds`.
503	Kuyruk/kapasite veya üst akış geçici olarak kullanılamıyor.	Üssel geri çekilme ve jitter ile yeniden dene.

Operasyon sözleşmesi

SocialVideoSaver, onaylanmış entegrasyona limitler atamadan önce tahmini çapraz ağ talebini inceler.

idempotent uygulama mantığını kullanın ve aynı kullanıcı tıklama için asla çifte işler başlatmayın.
Önbellek meta verileri kısaca çözer, ancak imzalanmış indirme URL'lerine her zaman son kullanma tarihi olarak davranır.
İçin sınırlı üstel geri çekilmeyi jitter ile kullanın 429, 503 ve yeniden denenebilir hatalar.
Sadece kamusal medya veya erişimine izin verdiğiniz medyayı işleyin. DRM ve erişim kontrolleri atlatılmadı.
İstek kimliklerini ve iş kimliklerini özel operasyon kayıtlarında tutun. Gereksiz yere gönderilen URL'leri kayıt altına almayın.

Keşif öncesi aktivasyon, SocialVideoSaver'da Şema erişimi için başlangıç noktasıdır. Ardından çok kaynaklı bir görünüm atanmış kimlik doğrulamayı sunar ve belgelenmiş istek şekillerini açıklar.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

Ağı çapraz ürün, tahmini aylık talep ve her sosyal sağlayıcı kapsamında özetleyin. SocialVideoSaver sadece istenen analiz veya iş yeteneklerini etkinleştirir ve token yerine bir hash saklar.

Aktivasyon iste Anahtarların kiracı kapsamı vardır, geri alınabilir ve İletişim formu aracılığıyla verilir. Anonim scriptler indirme işlemini gerçekleştiremez.