API-First Entegrasyonlar
Platformdaki her yetenek bir sözleşmedir — REST, GraphQL ve webhook — önce bir OpenAPI spesifikasyonu olarak yayınlanır, tipli SDK'ler olarak dağıtılır. Mühendislik ekibiniz Vucos'u Stripe veya Twilio'yu entegre ettiği şekilde entegre eder.
Platform, API'nin Kendisidir
Vucos API öncelikli olarak inşa edilmiştir; bu, operatör konsolundaki her ekranın ve tüketici uygulamasındaki her eylemin, halka açık ve belgelenmiş bir uç noktaya yaslandığı anlamına gelir. Gizli bir iç API yüzeyi yoktur, yalnızca UI üzerinden erişilebilen veri yoktur. REST uç noktaları entegrasyon işinin büyük bölümünü kaplar; GraphQL, katalog ve analitik için esnek sorgu kompozisyonunu açar ve bir webhook olay akışı durum değişikliklerini gerçek zamanlı olarak iter. Her şey sürümlenmiş, hız sınırlı ve gözlemlenebilirdir.
Neden önemli
Kara kutu olarak satılan OTT platformları, iş birimi sağlayıcının yol haritasında olmayan bir şeye ihtiyaç duyduğu anda yükümlülüğe dönüşür. Her özel akış — benzersiz bir onboarding, operatör faturalama entegrasyonu, bir sadakat programı, bir iş ortağı portalı — ya sağlayıcıyı bekler ya da kırılgan scraping ve polling ile platformun etrafına kablolanır. Bu geçici çözümler birikir ve 18 ay içinde entegrasyon borcu lisans maliyetini aşar.
API-first bir platform bu dinamiği tersine çevirir. Vucos'un dahili olarak kullandığı uç noktaların aynısı dışarıya açık olduğundan, ürünün yaptığı hiçbir şey ulaşılmaz değildir. Operatör mühendislik ekipleri özellikleri çeyreklerle değil günlerle sevk eder, iş ortakları aynı sözleşme üzerinden bağlanır ve iş senaryosu şekil değiştirdiğinde platform çalışmaya devam eder.
API yüzeyinin kapsadığı
REST API'leri
İçerik, abone, yetkilendirme, faturalama ve operasyon için kaynak odaklı REST. Her uç noktada tutarlı sayfalama, filtreleme ve hata sözleşmeleri.
GraphQL ağ geçidi
Katalog, kullanıcı ve analitik graf'larını birleştiren tek bir GraphQL uç noktası. İstemciler tam olarak ihtiyaç duydukları alanları çeker; kalıcı sorgular ve alan seviyesinde yetkilendirme.
Webhook olay akışı
Abonelik olayları, oynatma yaşam döngüsü, içerik durumu ve faturalama geçişleri için imzalı, yeniden denenebilir webhook'lar. Üstel geri çekilmeli at-least-once teslim ve bir replay API'si.
OpenAPI öncelikli spec
Her REST uç noktası yayınlanmadan önce OpenAPI 3.1'de tanımlanır. Aynı spec; sunucu stub'larını, SDK'leri ve etkileşimli dokümantasyon portalını besler — kod ve dokümanlar arasında sapma olmaz.
Tipli SDK'ler
Spec'ten üretilen TypeScript, Python, Go, Java, Kotlin ve Swift için birinci taraf SDK'ler. Tipli yanıtlar, yerleşik retry ve auth, uçtan uca iz yayılımı.
Hız sınırlama & sürümleme
Burst toleranslı kiracı başına sınırlar, kalan kotayı açıklayan yanıt başlıkları, açık API sürümlemesi ve minimum 12 aylık çakışmayla kullanımdan kaldırma politikaları.
Operatörler nasıl kullanıyor
Operatör faturalama entegrasyonu
Abonelik satın alma, yükseltme ve iptali operatörün mobil uygulamasından akar; uygulama Vucos faturalama API'lerine post ederken ücret operatör BSS üzerinden çekilir. Operatör işlemi onayladığında webhook olayları durumu mutabık kılar.
Otomatik içerik teslim boru hattı
Stüdyonun MAM'ı tamamlanmış master'ları ve meta veriyi REST ile Vucos'a iter; bu transkod, DRM paketleme ve yayımlamayı tetikler. Durum webhook'ları stüdyo dashboard'una geri besler; yapımcılar Vucos konsoluna girmeden yayın durumunu görür.
Ödül kullanımı & yetkilendirme verme
Bir seyahat ödülleri platformu, üyeler kilometre taşlarına ulaştığında ücretsiz SVOD erişimi vermek için Vucos yetkilendirme API'sini çağırır. Aynı webhook akışı aktivasyon ve kullanımı geri raporlar; sadakat programı etkileşimi puanlar.
Teknik detaylar
- REST (JSON:API tarzı)
- GraphQL ağ geçidi
- Webhook olay akışı
- Yüksek hacimli dahili için gRPC
- OpenAPI 3.1
- Direktifli GraphQL şeması
- Webhook'lar için AsyncAPI
- Payload'lar için JSON Schema
- TypeScript / JavaScript
- Python
- Go
- Java
- Kotlin
- Swift
- PKCE ile OAuth 2.1
- Makineden makineye JWT'ler
- Ortak entegrasyonları için API anahtarları
- İnce taneli kapsamlar
- Kiracı başına token bucket
- Burst + sürekli limitler
- Semantik API sürümleme
- 12 aylık kullanımdan kaldırma çakışması
- %99,95 API SLO'su
- Bölgesel okuma kopyaları
- Yazma işlemlerinde idempotency anahtarları
- Uzun görevler için asenkron iş kuyruğu
Key Takeaways
- Her uç nokta yayınlanmadan önce OpenAPI 3.1 spesifikasyonu yayımlanır
- Operasyonlar için REST, kompozisyon için GraphQL, olaylar için webhook
- TypeScript, Python, Go, Java, Kotlin ve Swift için tipli SDK'ler
- At-least-once teslim ve replay API'li imzalı, yeniden denenebilir webhook'lar
- Kalan kotayı başlıklarda açıklayan kiracı başına hız sınırları
- Durum yoklaması ile uzun süren operasyonlar için asenkron iş kuyruğu
Sıkça Sorulan Sorular
API'ler ne kadar kararlı — altımızda değişir mi?
REST mi GraphQL mi — hangisini kullanmalıyız?
Webhook'lar başarısızlıkları nasıl yönetiyor?
Hız sınırı duruşu nedir?
Üretim dışı bir örneğe karşı sandbox yapabilir miyiz?
Uzun süren operasyonlar nasıl modelleniyor?
İlgili
Modüler OTT Mimarisi
Tüm platformu alın, ilk günden çalışır. Herhangi bir parçayı kendinizinkiyle değiştirin — faturalama, DRM, öneriler, analitik — çalışmaya devam eder. Sözleşme bazında modüler, üretimde birleştirilebilir.
Read moreGözlemlenebilirlik & İzleme
İzler, metrikler ve log'lar — ilişkilendirilmiş, sorgulanabilir ve size ait. Sabah 3'teki bir olayı beş farklı sağlayıcı konsolu arasında kriz odası avına dönüştürmek yerine 9 dakikalık bir teşhis süresine indiren gözlemlenebilirlik omurgası.
Read moreWhitelabel OTT Platformu
Streaming işinizin her parçası için tek bir çekirdek motor — aboneler, içerik, yetkilendirmeler, faturalama, reklam ve cihaz uygulamaları — tek bir yönetim konsolundan işletilir ve her bölge, tenant ve monetizasyon modelinde tutarlı bir API ile yönetilir.
Read moreDaha fazlasını öğrenmeye hazır mısınız?
Bunun dağıtımınıza nasıl uyduğunu bir mimarla görüşün.