Sadece önizleme — etkinleştirme gerekli

QuickDL ile indirmeler oluşturun

QuickDL, geliştiricilerin etkinleştirme öncesinde kompakt istek modelini incelemesine olanak tanır. Destek, özel anahtar ve kota kullanılabilir hale gelmeden önce ürünü doğrulamalıdır.

QuickDlJobsHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

QuickDL'de, API ana bilgisayarı açıklanırken destek etkinleştirilmiş kimlik bilgileri önce gelir. Bu kompakt araç, atanmış bir kiracı uç noktası ile devam eder ve yalnızca sunucu çağrısı yolunda sona erer.

Kiracı URL'sihttps://quickdl.app

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliQuickDlJobs

API sürümüv1

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

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

QuickDL, Kimlik Bilgisi güvenliğini önce sunucu tarafı gizli depolamayı tanımlayarak ele alır. Ardından hiçbir istemci paketi gömmez ve genel günlükler veya depolar görünümünde tutmaz.

Bir bağlantıyı çözmek

QuickDL'de, Resolve işlemi açıklanırken önce kaynak algılama gelir. Bu kompakt yardımcı program, gönderilen bir URL'den formatları takip eder ve uydurulmuş çıktı olmadan kapanır.

POST/v1/resolveKapsam: çözüm

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

QuickDL, Format tanımlayıcısını önce döndürülen değeri değiştirmeden tanımlayarak işler. Ardından bağlantı başına kullanılabilirliği takip eder ve tahmini kalite etiketi görünümünde tutmaz.

Bir indirme işi oluştur ve takip et

QuickDL'nin kompakt aracı, İş oluşturma için eşzamansız hazırlığı inceliyor. Sonraki kısa HTTP isteğini gösterir ve bağlı çalışan yürütmesini gizlemez.

POST/v1/jobsKapsam: işler

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

1202 Kabul EdildiKaydet quick_job.

2Anket durumuGET /v1/jobs/{quick_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://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL, İş anketi için üç pratik nokta sunar. İlk olarak bir saniyelik başlangıç beklemesi gelir. Kompakt yardımcı program daha sonra sınırlı geri çekilmeyi kapsar. Son noktası geçici imzalı teslimattır.

Öngörülebilir hatalar

QuickDL, bir 2xx olmayan zarf aracılığıyla Hata sözleşmesine, ardından bir destek talebi kimliğine yaklaşır. Kompakt yardımcı program, öngörülebilir istemci işlemini açık 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

QuickDL, kaynak hizmetlerini istikrarsızlaştırmadan entegrasyonu destekleyen kompakt, istemciye özel bir kota verir.

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.

QuickDL'de, Şema erişimi açıklanırken keşif öncesi etkinleştirme önce gelir. Bu kompakt araç, atanmış kimlik doğrulama ile devam eder ve belgelenmiş istek şekilleriyle sona erer.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

QuickDL'e entegrasyon adını, beklenen aylık hacmi ve gerekli kaynakları sağlayın. Sunucunun gerçekleştireceği işlemleri belirleyin, böylece onay dar kapsamlı, tek seferlik bir anahtar üretir.

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.