https://easyt.ioEasyT ile indirmeler oluştur
Bu EasyT referansı, aktif anonim bir uç nokta değil, bir uygulama kılavuzudur. Üretim erişimi, destek istemciyi onaylayıp sınırlar atadıktan sonra başlar.
Hızlı başlangıç
API ana bilgisayarı, EasyT üzerinde destek etkinleştirilmiş kimlik bilgileriyle başlar. Bu yönlendirilmiş kontrol, atanmış bir kiracı uç noktasını sunar. Son gerçek, yalnızca sunucu çağrı yoludur.
X-API-Key: pending_activation_…EasytWorkspacev1# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"
curl -X POST https://easyt.io/v1/resolve \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'EasyT'de, Kimlik Bilgisi güvenliği açıklanırken sunucu tarafı gizli depolama ilk sırada gelir. Bu rehberli kontrol, istemci paketi gömme olmamasıyla devam eder ve halka açık günlükler veya depolar olmamasıyla sona erer.
Bir bağlantıyı çözmek
Çözüm işlemi EasyT üzerinde kaynak algılaması ile başlar. Bu yönlendirilmiş kontrol ardından gönderilen bir URL'den formatları sunar. Son gerçek, uydurulmuş çıktıların olmamasıdır.
/v1/resolveKapsam: çözüm| Alan | Tip | Gerekli | Açıklama |
|---|---|---|---|
input_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
}EasyT'de, Format tanımlayıcı açıklanırken döndürülen değişmemiş değer ilk sırada gelir. Bu rehberli kontrol, bağlantı başına kullanılabilirlikle devam eder ve tahmin edilen kalite etiketi olmamasıyla sona erer.
Bir indirme işi oluştur ve takip et
Asenkron hazırlık, EasyT üzerinde İş oluşturmanın başlangıç noktasıdır. Yönlendirilmiş bir kontrol, kısa bir HTTP isteği sunar ve sınırlandırılmış çalışan yürütmesini açıklar.
/v1/jobsKapsam: işler| Alan | Tip | Gerekli | Açıklama |
|---|---|---|---|
input_url | HTTPS URL'si | Evet | Çözümlemek için gönderilen aynı normalize edilmiş kaynak. |
stream_choice | dize | Evet | Çözüm yanıtından tam bir kimlik. |
tenant | dize | Hayır. | Atanmış kiracı alanı. Genellikle atlanır. |
curl -X POST https://easyt.io/v1/jobs \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'workspace_job.GET /v1/jobs/{workspace_job} 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://easyt.io/v1/jobs/WORKSPACE_JOB \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN"İş anketi için, EasyT bir saniyelik başlangıç beklemesi ile başlar. Yönlendirilmiş kontrolü, sınırlandırılmış geri çekilme ile eşleştirir ve geçici imzalı teslimatla sona erer.
Öngörülebilir hatalar
EasyT, Hata sözleşmesini kolayca taranabilir hale getirir. Sayfa, bir adet 2xx olmayan zarfla başlar, bir destek talebi kimliğine geçer ve öngörülebilir istemci işlemesini açıkça belirtir.
{
"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
EasyT, uygulamanın ihtiyaçları ile sağlayıcı sağlığını dengeleyerek inceleme sırasında bir işletme izni seçer.
- 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.
Şema erişimi, EasyT üzerinde keşif öncesinde etkinleştirme ile başlar. Bu rehberli kontrol ardından atanan kimlik doğrulamayı sunar. Son gerçek, belgelenmiş istek biçimleridir.
Destek aracılığıyla etkinleştir
Aktivasyon notuna müşteri amacı, beklenen aylık iş yükü ve talep edilen ağları dahil edin. EasyT, ardından bir görünüm gizliliği oluşturmadan önce çözüm ve iş kapsamlarını doğru şekilde seçebilir.
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.