Sadece önizleme — etkinleştirme gerekli

FFast ile indirme yap

FFast, genel çağrıları açmadan amaçlanan API yapısını ortaya koyar. Bir operatör, önerilen entegrasyonu inceledikten sonra kimlik bilgilerini ve ölçülen kotaları etkinleştirir.

FfastPipelineHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

FFast, API sunucusuna destek etkinleştirilmiş kimlik bilgileri aracılığıyla, ardından atanmış bir kiracı uç noktasıyla yaklaşır. Hızlı inceleme, yalnızca sunucu çağrı yolunu açık tutar.

Kiracı URL'sihttps://ffast.app

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliFfastPipeline

API sürümüv1

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

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

İdentifikatör güvenliği için, FFast, hiçbir istemci paketi gömmeden önce sunucu tarafındaki gizli depolamayı kontrol eder. Bu hızlı inceleme ayrıca hiçbir kamu log'unu veya depoyu netleştirir.

Bir bağlantıyı çözmek

FFast, Resolve işlemini kaynak algılaması yoluyla yaklaşır, ardından bir gönderilen URL'den biçimlendirir. Hızlı inceleme, uydurulmuş çıktıları açıkça tutmaz.

POST/v1/resolveKapsam: çözüm

Alan	Tip	Gerekli	Açıklama
`fast_source`	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ı için FFast, bağlantı başına kullanılabilirlikten önce döndürülen değeri değiştirmeden kontrol eder. Bu hızlı inceleme ayrıca tahmini kalite etiketini netleştirmez.

Bir indirme işi oluştur ve takip et

FFast, iş oluşturmayı önce eşzamansız hazırlığı tanımlayarak yönetir. Ardından kısa bir HTTP isteği yapar ve sınırlı işçi yürütmesini göz önünde bulundurur.

POST/v1/jobsKapsam: işler

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

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

1202 Kabul EdildiKaydet pipeline_run.

2Anket durumuGET /v1/jobs/{pipeline_run} 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://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

İş sorgulaması, FFast'de bir saniyelik ilk bekleme ile başlar. Sonraki görünüm sınırlandırılmış geri çekilmeyi kapsar. Sayfa geçici imzalı teslimatı görünür tutar.

Öngörülebilir hatalar

FFast'in hızlı incelemesi, Hata sözleşmesi için bir adet 2xx olmayan zarfı inceler. Sonraki destek talebi kimliğini gösterir ve öngörülebilir istemci işlemesini gizlemez.

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

FFast, üst akış platformlarına güvensiz yük bindirmeden geçişin duyarlı kalmasını sağlayan ölçülen kotaları etkinleştirir.

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.

FFast, Şema erişimine keşif öncesi aktivasyon yoluyla yaklaşır, ardından atanan kimlik doğrulama gelir. Hızlı inceleme, belgelenmiş istek şekillerini açık tutar.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

FFast için kısa bir ürün özeti, trafik projeksiyonu ve platform listesi verin. Verilen anahtarın gerçek iş akışıyla eşleşmesi için meta veri kontrolleri, hazırlanmış işler veya her ikisinin gerekli olup olmadığını belirtin.

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.