Sadece önizleme — etkinleştirme gerekli

downf.io ile indirmeler oluştur

DownF, bir operatör uyumluluk kullanım durumunu inceleyene kadar API yürütmesini devre dışı tutar. Örnekler planlanan sözleşmeyi tanımlar, gerçek kimlik bilgileri ve kota ise yalnızca destek etkinleştirmesiyle gelir.

DownfBridgeHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

DownF, API ana bilgisayarını desteklenmiş etkinleştirilmiş kimlik bilgileri etrafında organize eder. Uyumluluk görünümü, atanmış bir kiracı uç noktasını karşılaştırır. Yalnızca sunucu çağrı yolu son kontrol olarak kalır.

Kiracı URL'sihttps://downf.io

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliDownfBridge

API sürümüv1

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

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

İdentifikatör güvenliği, DownF üzerindeki sunucu tarafındaki gizli depolama ile başlar. Bu uyumluluk görünümü, daha sonra hiçbir istemci paketi gömme sunuyor. Son gerçek, kamuya açık kayıtlar veya depo yoktur.

Bir bağlantıyı çözmek

DownF, Resolve işlemini kaynak tespiti etrafında organize eder. Uyumluluk görünümü, gönderilen bir URL'den formatları karşılaştırır. Hiçbir uydurma çıktı nihai kontrol olarak kalmaz.

POST/v1/resolveKapsam: çözüm

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

Format tanımlayıcı, DownF'de döndürülen değer değişmeden başlar. Bu uyumluluk görünümü daha sonra bağlantı başına kullanılabilirliği sunar. Son gerçek, tahmin edilen kalite etiketi olmamasıdır.

Bir indirme işi oluştur ve takip et

İş oluşturma, DownF'de eşzamansız hazırlıkla başlar. Sonraki görünüm kısa bir HTTP isteğini kapsar. Sayfa, sınırlı çalışan yürütmesini görünür tutar.

POST/v1/jobsKapsam: işler

Alan	Tip	Gerekli	Açıklama
`media_address`	HTTPS URL'si	Evet	Çözümlemek için gönderilen aynı normalize edilmiş kaynak.
`output_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://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'

1202 Kabul EdildiKaydet transfer_ref.

2Anket durumuGET /v1/jobs/{transfer_ref} 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://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

DownF'in uyumluluk görünümü, İş sorgulaması için bir saniyelik ilk beklemeyi inceler. Sonraki sınırlandırılmış geri çekilmeyi gösterir ve geçici imzalı teslimatı gizlemez.

Öngörülebilir hatalar

DownF, Hata sözleşmesi için üç pratik nokta sunar. İlk olarak bir non-2xx zarf gelir. Uyumluluk görünümü ardından bir destek talebi kimliğini kapsar. Son noktası ise öngörülebilir istemci işlemedir.

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

DownF, hedeflenen istemciyi inceledikten sonra bir istek sınırı belirler ve uyumluluk kontrolleri ile üst sağlayıcıları stabil tutar.

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.

DownF, Şema erişimini keşif öncesi etkinleştirme etrafında organize eder. Uyumluluk görünümü, atanan kimlik doğrulamayı karşılaştırır. Belgelendirilmiş istek şekilleri son kontrol olarak kalır.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

Ürünü tanımlayın, aylık çağrı tahminini yapın ve analiz etmesi gereken platformları listeleyin. DownF desteği, yalnızca bir hash olarak saklanan görünür tek seferlik bir kimlik bilgisi vermeden önce gerekli kapsamları onaylayacaktır.

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.