Sadece önizleme — etkinleştirme gerekli

EasyF ile indirmeler oluşturun

EasyF, geliştiricilerin çalışmalarını tahmin edebilmesi için arayüzü önceden gösterir. Canlı anahtar ve kullanım sınırı olmadan önce destek incelemesi gereklidir.

EasyfClientHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

API ana bilgisayarını açıklamak için, EasyF destek etkinleştirilmiş kimlik bilgilerini atanmış bir kiracı uç noktasından ayırır. Düz dil iş akışı, yalnızca sunucu çağrı yoluna kendi yerini verir.

Kiracı URL'sihttps://easyf.app

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliEasyfClient

API sürümüv1

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

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

Kimlik bilgisi güvenliği, EasyF üzerinde sunucu tarafı gizli depolama ile başlar. Sonraki görünüm, istemci paketi gömme olmamasını kapsar. Sayfa, görünür kamu günlükleri veya depoları tutmaz.

Bir bağlantıyı çözmek

Resolve işlemini açıklamak için, EasyF kaynak algılamayı gönderilen bir URL'den formatlardan ayırır. Düz anlatımlı bir iş akışı, uydurulmuş çıktılara kendi yerini vermez.

POST/v1/resolveKapsam: çözüm

Alan	Tip	Gerekli	Açıklama
`asset_url`	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ı, EasyF üzerinde döndürülen değeri değişmeden başlatır. Sonraki görünüm bağlantı başına kullanılabilirliği kapsar. Sayfa, tahmin edilen kalite etiketini görünür tutmaz.

Bir indirme işi oluştur ve takip et

EasyF İş yaratımı için üç pratik nokta sunar. İlk olarak eşzamansız hazırlık gelir. Düz dil iş akışı ardından kısa bir HTTP isteğini kapsar. Son noktası ise sınırlı işçi yürütmesidir.

POST/v1/jobsKapsam: işler

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

1202 Kabul EdildiKaydet delivery_id.

2Anket durumuGET /v1/jobs/{delivery_id} 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://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF Bir saniyelik başlangıç beklemesi, ardından kapalı geri çekilme yoluyla İş oylamasına yaklaşır. Sade dil çalışma akışını geçici imzalı teslimat açıkça tutar.

Öngörülebilir hatalar

EasyF, Hata sözleşmesini bir adet 2xx olmayan zarf etrafında organize eder. Düz dil iş akışı, destek talebi kimliğini karşılaştırır. Öngörülebilir istemci işleme son kontrol olarak kalır.

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

EasyF, tahmin edilebilir bir rehberli iş akışını korumak için her onaylanmış ürünle pratik kullanım sınırları üzerinde anlaşmaktadır.

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.

Şema erişimini açıklamak için, EasyF keşif öncesi etkinleştirmeyi atanan kimlik doğrulamadan ayırır. Düz dil iş akışı, belgelenmiş istek biçimlerine kendi yerini verir.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

EasyF'e ne inşa ettiğinizi, API'yi ne sıklıkla çağıracağını ve hangi sağlayıcıların önemli olduğunu söyleyin. İnceleme, izin verilen işlemleri belirler, ardından yalnızca güvenli özetini kaydederken bir kimlik bilgisi ortaya çıkarı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.