https://quickt.ioQuickT ile indirmeler oluşturun
QuickT, bir mobil istemcinin hizmetle nasıl iletişim kuracağını belgelemektedir. Destek tasarımı onaylayıp kapsamlı erişimi etkinleştirmeden üretim çalışması gönderemez.
Hızlı başlangıç
API sunucusu için, QuickT, atanmış bir kiracı uç noktasından önce destek etkinleştirilmiş kimlik bilgilerini kontrol eder. Bu cihaz hazır görünümü ayrıca yalnızca sunucu çağrı yolunu netleştirir.
X-API-Key: pending_activation_…QuicktRoutev1# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"
curl -X POST https://quickt.io/v1/resolve \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickT, Kimlik Bilgisi güvenliğini sunucu tarafı gizli depolama etrafında organize eder. Cihaz hazır görünümü, istemci paketi gömme karşılaştırması yapmaz. Hiçbir genel günlük veya depo son kontrol olarak kalır.
Bir bağlantıyı çözmek
Resolve işlemi için, QuickT, gönderilen tek bir URL'den formatlar öncesinde kaynak algılamayı kontrol eder. Bu cihaz hazır görünümü ayrıca uydurma çıktıların olmadığını açıkça gösterir.
/v1/resolveKapsam: çözüm| Alan | Tip | Gerekli | Açıklama |
|---|---|---|---|
route_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
}QuickT, Format tanımlayıcısını döndürülen değer etrafında değişmeden organize eder. Cihaz hazır görünümü, bağlantı başına kullanılabilirliği karşılaştırır. Tahmini kalite etiketi son kontrol olarak kalmaz.
Bir indirme işi oluştur ve takip et
İş oluşturmayı açıklamak için QuickT eşzamansız hazırlığı kısa bir HTTP isteğinden ayırır. Cihaz hazır görünümü, sınırlı çalışan yürütmesine kendi alanını verir.
/v1/jobsKapsam: işler| Alan | Tip | Gerekli | Açıklama |
|---|---|---|---|
route_source | HTTPS URL'si | Evet | Çözümlemek için gönderilen aynı normalize edilmiş kaynak. |
route_format | dize | Evet | Çözüm yanıtından tam bir kimlik. |
tenant | dize | Hayır. | Atanmış kiracı alanı. Genellikle atlanır. |
curl -X POST https://quickt.io/v1/jobs \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'route_job.GET /v1/jobs/{route_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://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Bir saniyelik ilk bekleme, QuickT'de İş sorgulamasının başlangıç noktasıdır. Cihaza hazır görünüm, sınırlandırılmış geri çekilmeyi sunar ve geçici imzalı teslimatı açıklar.
Öngörülebilir hatalar
Hata sözleşmesi için, QuickT bir adet 2xx olmayan zarfla başlar. Cihaz hazır görünümü bunu bir destek talebi kimliği ile eşleştirir ve öngörülebilir istemci işlemi ile sona erer.
{
"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
QuickT, onay sırasında mobil istemci sınırlarını seçer, böylece yaratıcı ağlar ve API yanıt verir kalı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,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 için, QuickT atamadan önce etkinleştirmeyi, keşiften önce kontrol eder. Bu cihaza hazır görünüm ayrıca belgelenmiş istek şekillerini netleştirir.
Destek aracılığıyla etkinleştir
Mobil deneyimi, trafik beklentisini ve ihtiyaç duyduğu yaratıcı ağları tanımlayın. QuickT, sırrı açıklamadan önce analiz ve kuyruk izinlerini atamak için bu bilgileri kullanı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.