Sadece önizleme — etkinleştirme gerekli

Insto ile indirme yap

Insto değerlendirme için görsel-medya entegrasyonu planını sunar. Canlı analiz ve iş talepleri, destek kiracı kapsamlı yetkilendirmeyi verene kadar kullanılamaz kalır.

InstoMediaHTTPS üzerinden JSONAsync İşleriKapsamlı kimlik bilgileri

Hızlı başlangıç

API host için, Insto destek etkinleştirilmiş kimlik bilgileri ile başlar. Onun indirme inceleme bunu bir atanmış kiracı son noktası ile çiftler ve sadece sunucu çağrı yolu ile sonlanır.

Kiracı URL'sihttps://insto.app

Kimlik doğrulamaX-API-Key: pending_activation_…

Müşteri profiliInstoMedia

API sürümüv1

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

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

Insto, Kimlik Bilgisi güvenliği için üç pratik nokta sunar. İlk olarak sunucu tarafı gizli depolama gelir. İndirme incelemesi daha sonra istemci paketi gömme olmadığını kapsar. Son noktası ise halka açık günlükler veya depoların olmamasıdır.

Bir bağlantıyı çözmek

Çözümleme işlemi için, Insto kaynak tespiti ile başlar. Onun indirme incelemesi, bunu bir gönderilen URL'den gelen biçimlerle çiftleştirir ve hiçbir icat edilmiş çıktı ile sonlanır.

POST/v1/resolveKapsam: çözüm

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

Insto, Format tanımlayıcı için üç pratik nokta sunar. İlk olarak, döndürülen değer değişmeden kalır. İndirme incelemesi daha sonra bağlantı başına kullanılabilirliği kapsar. Son noktası ise tahmin edilen kalite etiketi olmamasıdır.

Bir indirme işi oluştur ve takip et

Insto, İş oluşturmayı senkronize olmayan hazırlık etrafında organize eder. İndirme incelemesi kısa bir HTTP talebini karşılaştırır. Sınırlanmış işçi yürütmesi son kontrol olarak kalır.

POST/v1/jobsKapsam: işler

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

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

1202 Kabul EdildiKaydet prepare_id.

2Anket durumuGET /v1/jobs/{prepare_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://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Insto'de, bir saniyelik başlangıç beklemesi ilk olarak gelir İş anket açıklaması yapılırken. O indirme incelemesi kapalı geri çekilme ile takip eder ve geçici imzalı teslimat üzerinde kapanır.

Öngörülebilir hatalar

Açıklamak Hata sözleşmesi, Insto bir destek talebi kimliğinden bir 2xx olmayan zarfı ayırır. Bir indirme incelemesi öngörülebilir müşterinin kendi yerini ele almasını sağlar.

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

Insto, görüşme sınırlarını görsel-medya kullanım vakasına ve onaylanmış istemcinin iletişime geçeceği ağlara göre özelleş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.

Şema erişimi için, Insto keşif öncesi etkinleştirme ile başlar. Onun indirme incelemesi, o ile atanmış kimlik doğrulama çiftler ve belgelenmiş talep şekilleri ile biter.

OPERATÖR İNCELEMELİ ERİŞİM

Destek aracılığıyla etkinleştir

Görsel-medya ürününü, beklenen aylık kullanımınızı ve yönetmeyi planladığınız gönderi türlerini ana hatlarıyla belirtin. Insto yalnızca gerekli analiz veya hazırlık kapsamlarını verir ve okunabilir belirteci asla saklamaz.

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.