Sadece önizleme — etkinleştirme gerekli

SaveTK ile indirmeler oluşturun

SaveTK, yaratıcı-alet entegrasyonları için bir API planı gösterir, ancak kimlik doğrulamasız yürütmeyi kabul etmez. Onay hem anahtarı hem de işletim sınırlarını temin eder.

SaveTkCreatorHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

SaveTK, API sunucusu için üç pratik nokta sunar. İlk olarak destek etkinleştirilmiş kimlik bilgileri gelir. Kaydetme iş akışı daha sonra atanmış bir kiracı uç noktasını kapsar. Son noktası ise yalnızca sunucu çağrı yoludur.

Kiracı URL'sihttps://savetk.app

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliSaveTkCreator

API sürümüv1

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

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

SaveTK Kimlik Bilgisi güvenliğini kolayca taranabilir hale getirir. Sayfa, sunucu tarafı gizli depolama ile başlar, istemci paketi gömme olmadan devam eder ve açıkça halka açık günlükler veya depolar olmadığını belirtir.

Bir bağlantıyı çözmek

SaveTK, Resolve işlemi için üç pratik nokta sunar. İlk olarak kaynak tespiti gelir. Kaydetme iş akışı daha sonra tek bir gönderilen URL'den formatları kapsar. Son noktası ise uydurulmuş çıktıların olmamasıdır.

POST/v1/resolveKapsam: çözüm

Alan	Tip	Gerekli	Açıklama
`creator_link`	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
}

SaveTK, Format tanımlayıcısını kolayca taranabilir hale getirir. Sayfa, döndürülen değeri değiştirmeden başlatır, bağlantı başına kullanılabilirliğe geçer ve tahmin edilen kalite etiketi olmadığını açıkça belirtir.

Bir indirme işi oluştur ve takip et

İş oluşturma SaveTK üzerindeki senkronize hazırlıkla başlar. Bu tasarruf iş akışı daha sonra kısa bir HTTP talebi sunar. Son gerçek sınırlı çalışan yürütmedir.

POST/v1/jobsKapsam: işler

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

curl -X POST https://savetk.app/v1/jobs \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID","save_option":"18"}'

1202 Kabul EdildiKaydet save_task.

2Anket durumuGET /v1/jobs/{save_task} 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://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

SaveTK, ilk olarak bir saniyelik başlangıç beklemesini tanımlayarak İş oylamasını ele alır. Kapatılmış geri çekilme ile takip eder ve geçici imzalı teslimatı göz önünde tutar.

Öngörülebilir hatalar

Hata sözleşmesi SaveTK üzerinde bir 2xx olmayan zarfla başlar. Bir sonraki görünüm bir destek talebi kimliğini kapsar. Sayfa, tahmin edilebilir istemci işlemesini görünür tutar.

{
  "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

SaveTK, beklenen trafiği ve kapsamdaki yayın platformlarını inceledikten sonra yaratıcı-iş akışı izinlerini belirler.

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.

SaveTK, Şema erişimi için üç pratik nokta sunar. İlk olarak keşif öncesi etkinleştirme gelir. Kaydetme iş akışı daha sonra atanmış kimlik doğrulamayı kapsar. Son noktası belgelenmiş istek şekilleridir.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

SaveTK istemcisinin ne yaptığını, kaç çağrı beklediğini ve hangi gönderi hizmetlerinin gerekli olduğunu belirtin. Destek incelemesi kapsamlarını seçer, ardından yalnızca bir kez gösterilen kurtarılamaz bir kimlik bilgisi döner.

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.