https://dwtt.appDWTT ile indirme yap
DWTT bu entegrasyon çizimi anonim yürütme değil, planlama için yayınlar. Destek, kapsamlı bir anahtar ve onun trafik ödeneği vermeden önce klip iş akışını onaylaması gerekir.
Hızlı başlangıç
DWTT API host tarama kolaylaştırır. Sayfa destek etkinleştirilmiş kimlik bilgileri ile başlar, atanmış bir kiracı son noktasına hareket eder ve sadece sunucu çağrı yolu açıkça belirtir.
X-API-Key: pending_activation_…DwttToolkitv1# Available only after support activation
export DWTT_TOOL_TOKEN="issued-after-review"
curl -X POST https://dwtt.app/v1/resolve \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'DWTT sunucu tarafındaki gizli depolama aracılığıyla İdentifikatör güvenliğine yaklaşır, daha sonra istemci paketi gömme yoktur. Rahatlaştırılmış iş akışı açıkça hiçbir kamu log'u veya depo tutmaz.
Bir bağlantıyı çözmek
DWTT, Resolve işlemini taramayı kolaylaştırır. Sayfa, kaynak tespitiyle başlar, bir gönderilen URL'den formatlara geçer ve icat edilmiş hiçbir çıktı olmadığını açıkça belirtir.
/v1/resolveKapsam: çözüm| Alan | Tip | Gerekli | Açıklama |
|---|---|---|---|
source_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
}DWTT yaklaşımları Format tanımlayıcı değeri dönüştürülmüş değişmeden, sonra bağlantı başına erişilebilirlik aracılığıyla. Akıllıca çalışma akışını hiçbir tahmin kalite etiketi açıkça tutar.
Bir indirme işi oluştur ve takip et
DWTT'de, İş oluşturma açıklanırken ilk önce senkronize hazırlık gelir. O optimize edilmiş iş akışı kısa bir HTTP talebi ile takip eder ve sınırlı çalışan yürütümü üzerinde kapanır.
/v1/jobsKapsam: işler| Alan | Tip | Gerekli | Açıklama |
|---|---|---|---|
source_link | HTTPS URL'si | Evet | Çözümlemek için gönderilen aynı normalize edilmiş kaynak. |
format_ref | dize | Evet | Çözüm yanıtından tam bir kimlik. |
tenant | dize | Hayır. | Atanmış kiracı alanı. Genellikle atlanır. |
curl -X POST https://dwtt.app/v1/jobs \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID","format_ref":"18"}'task_ref.GET /v1/jobs/{task_ref} aynı anahtarla.| 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_codeSadece önerildiğinde yeniden deneyin. |
expired | Geçici çıktı kaldırıldı. | Yeni bir iş oluşturun. |
curl https://dwtt.app/v1/jobs/TASK_REF \
-H "X-API-Key: $DWTT_TOOL_TOKEN"İş anketlerini açıklamak için, DWTT, bir saniyelik başlangıç bekleme süresini kapalı geri çekilmeden ayırır. Rahatlaştırılmış bir iş akışı, geçici imzalı teslimata kendi yerini verir.
Öngörülebilir hatalar
2xx olmayan bir zarfı DWTT üzerinde Hata sözleşmesi için başlangıç noktasıdır. Daha sonra optimize edilmiş bir iş akışı bir destek talebi kimliği sunar ve tahmin edilebilir istemci işlemesini açıklar.
{
"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
DWTT, klip entegrasyonları ve kaynak ağları aşırı yüklenmesin diye etkinleştirme sırasında trafik 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,503ve 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.
DWTT, Şema erişimini taramayı kolaylaştırır. Sayfa, keşif öncesi etkinleştirme ile başlar, atanmış kimlik doğrulamasına geçer ve belgelenmiş talep şekillerini açıkça belirtir.
Destek aracılığıyla etkinleştir
DWTT'e planlanan entegrasyonu, muhtemel istek hacmini ve hedef ağları gönderin. İstemcinin çözünürlük, iş oluşturma veya her ikisine ihtiyaç duyup duymadığını belirtin, böylece kapsamlı bir anahtar onaylanabilir ve gösterilebilir.
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.