Sadece önizleme — etkinleştirme gerekli

Insts ile indirmeler oluşturun

Aşağıdaki Insts çalışma tezgahı, potansiyel bir müşteri için dokümantasyondur. Operatör incelemesi, herhangi bir yürütülebilir kimlik bilgisi veya çağrı izni oluşturulmadan önce gelir.

InstsConnectHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

API ana bilgisayarı, Insts üzerinde destek etkinleştirilmiş kimlik bilgileriyle başlar. Sonraki görünüm, atanmış bir kiracı uç noktasını kapsar. Sayfa, yalnızca sunucu çağrısı yolunu görünür tutar.

Kiracı URL'sihttps://insts.io

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliInstsConnect

API sürümüv1

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

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

Sunucu tarafı gizli depolama, Insts üzerinde Kimlik Bilgisi güvenliğinin başlangıç noktasıdır. Bir inceleme tezgahı, istemci paketi gömme olmadığını sunar ve halka açık günlükler veya depolar olmadığını açıklar.

Bir bağlantıyı çözmek

Çözümleme işlemi, Insts üzerinde kaynak tespiti ile başlar. Sonraki görünüm, gönderilen tek bir URL'den formatları kapsar. Sayfa, uydurulmuş çıktıları görünür tutmaz.

POST/v1/resolveKapsam: çözüm

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

Değişmeden geri değeri Insts üzerinde Format tanımlayıcı için başlangıç noktasıdır. Bir muayene bankası daha sonra bağlantı başına erişilebilirliği sunar ve tahmin edilen kalite etiketi olmadığını açıklar.

Bir indirme işi oluştur ve takip et

Insts, İş oluşturmayı kolayca taranabilir hale getirir. Sayfa, eşzamansız hazırlıkla başlar, kısa bir HTTP isteğine geçer ve sınırlandırılmış işçi yürütmesini açıkça belirtir.

POST/v1/jobsKapsam: işler

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

1202 Kabul EdildiKaydet connect_job.

2Anket durumuGET /v1/jobs/{connect_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://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

İş anketi için, Insts bir saniyelik ilk beklemeyi kontrol eder ve ardından sınırlandırılmış geri çekilme uygular. Bu inceleme bankası ayrıca geçici imzalı teslimatı da netleştirir.

Öngörülebilir hatalar

Hata sözleşmesi, Insts üzerinde bir adet 2xx olmayan zarfla başlar. Bu denetim tezgahı ardından bir destek talebi kimliği sunar. Son gerçek, öngörülebilir istemci işlemedir.

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

Insts, inceleme sırasında denetim çalışma alanını ve her sağlayıcı yolunu korumak için oran sınırları belirler.

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şimi, Insts üzerinde keşif öncesi aktivasyonla başlar. Sonraki görünüm, atanmış kimlik doğrulamayı kapsar. Sayfa, belgelenmiş istek biçimlerini görünür tutar.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

İş masası kullanım vakasını, tahmini çağrı sayısını ve inceleme altındaki hizmetleri paylaşın.Insts bir kiracı kimlik bilgileri bir kez görüntülenmeden önce o sınırı gözden geçirir ve depolanan bir hash'e indirir.

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.