Geliştirici Dokümanları

Vidora API Referansı

Vidora'yı uygulamana entegre etmek için ihtiyaç duyacağın her şey — embed, REST API, webhook ve SDK'lar.

Hızlı Başlangıç

/kayit sayfasından hesap oluştur (ücretsiz paket dahil).
Panel → Ayarlar → API Anahtarları menüsünden yeni anahtar üret.vid_pk_…
İlk videonu yükle (Panel → Videolar → Yükle).
Hazır olduğunda dilediğin sayfaya <iframe src="https://player.vidora.com.tr/v/{videoId}" /> ile gömmeye başla.

Bölümler

Embed Entegrasyonu

Tek bir embed.js sitenize üç farklı modda shoppable video katmanı getirir. Hangisi sizin için uygunsa onu kullanın — birden fazlasını aynı sayfada karıştırabilirsiniz.

Mod A

Tam Player (iframe)

Vidora'nın kendi player'ı (kontroller, autoplay, layout) tek tıkla yerleşir. En kolay başlangıç.

<div data-vidora="vid_XXXXXXXX"></div>
<script async src="https://player.vidora.com.tr/embed.js"></script>

Opsiyonel: data-aspect="9x16", data-width="480", data-preset="1080p".

Mod B

Native MP4 + Otomatik Shoppable

Yeni

Sitenizde zaten kendi <video> etiketinizi mi kullanıyorsunuz? Sorun değil. cdn.vidora.com.tr URL'sini kullanan herhangi bir video etiketinin üzerine shoppable katmanımız otomatik giyilir. Player'ı, tasarımı veya kontrolleri değiştirmeniz gerekmez.

<video
  src="https://cdn.vidora.com.tr/organizations/org_X/videos/vid_XXX/renders/720p.mp4"
  controls poster="https://cdn.vidora.com.tr/...poster.jpg">
</video>
<script async src="https://player.vidora.com.tr/embed.js"></script>

Embed.js sayfayı tarar, Vidora CDN URL'si tespit eder, video ID'sini çıkarır ve panel'de seçili shoppable şablonunu video üzerine transparent iframe olarak enjekte eder. Analytics (görüntülenme, tıklama, sepet) otomatik toplanır.

Mod C

Kendi CDN'in / Manuel ID

Videoyu kendi CDN'inize indirip serve ediyorsanız, video ID'sini bir attribute olarak verin — gerisi Mod B ile aynı.

<video
  src="https://cdn.benim-sitem.com/videos/foo.mp4"
  data-vidora-id="vid_XXXXXXXX"
  controls>
</video>
<script async src="https://player.vidora.com.tr/embed.js"></script>

İpuçları

SPA / Next.js / React sitelerinde dynamic eklenen videolar MutationObserver ile otomatik yakalanır; ekstra kod yazmanız gerekmez.
Layout override: data-vidora-layout="tiktok-compact"
Custom domain panel API: data-vidora-api="https://panel.example.com" (white-label kurulumlar için).
Domain whitelist: Panel → Ayarlar → Domain Whitelist'te sayfanızın host'u kayıtlı olmalı (boş liste = açık).

REST API — v1

Base URL: https://panel.vidora.com.tr/api/v1

Detaylı endpoint dökümantasyonu interaktif bir API explorer'a taşınmaktadır. Bu sırada [email protected] adresine yazarsanız geliştirici ekibimiz size doğrudan yardımcı olur.

Erken erişim ister misin?

Webhook'lar ve SDK'lar için beta listemize katılarak yayına çıkar çıkmaz haberdar olabilirsin.

Beta listesine katıl