Beş dakikada ilk çağrınız

Bu sayfadan çıkmadan, sıfırdan API ile oluşturulmuş canlı bir oturuma.

Başlamadan önce

  • Ücretli bir plandaki hesap: API, FREE planına dahil değildir (referansın tamamına ödeme yapmadan da göz atabilirsiniz).
  • Çalışma alanınızda bir sunum: oluşturmak üzere olduğunuz oturum, var olan bir sunumu çalıştırır.

  1. Kimlik bilginizi oluşturun

    Çalışma alanınızda Kuruluş → API bölümünü açın ve content:write iznine sahip bir kimlik bilgisi oluşturun. Gizli anahtar bir kez gösterilir: kaydedin.

    API anahtarınızı alın

    Kimlik bilgisi kullanıcınıza değil kuruluşa aittir: her yönetici onu iptal edebilir ve her kullanım denetim günlüğüne düşer. Yalnızca ihtiyacınız olan izinleri isteyin — okumak için results:read, oluşturup yönetmek için content:write.

  2. Bir oturum oluşturun ve açın

    Anahtarınız X-API-Key başlığındayken, var olan bir sunum üzerinde oturum oluşturun ve açın.

    curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/sessions \
  -H "X-API-Key: vz_live_…" \
  -d '{ "presentation_id": "prs_8f3k2" }'

curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/sessions/ses_71xw9/open \
  -H "X-API-Key: vz_live_…"

    Oturum DRAFT olarak doğar; açmak join_code değerini üretir ve oda hazır olur. Yanıttaki X-RateLimit-* başlıklarını izleyin: her yanıtta gelirler ve 60 saniyelik pencerede ne kadar istek bütçeniz kaldığını söylerler.

  3. Sonuçları alın

    question.results.finalized için bir webhook kaydedin ve imzalı toplamları arka ucunuzda alın.

    curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/webhooks \
  -H "X-API-Key: vz_live_…" \
  -d '{ "url": "https://example.com/hooks/votinova",
        "event_types": ["question.results.finalized"] }'

    Kaydın döndürdüğü signing_secret değerini saklayın: bir kez gösterilir ve her teslimatı doğrulamanızı sağlayan şey odur. Webhook kılavuzu, doğrulamayı üç dilde yapıştırmaya hazır sunar.

Bir şey ters görünüyorsa

  • 401 — X-API-Key başlığı ya da izin eksik: gövde, hangisi olduğunu required_scope alanında söyler.
  • 402 — planınız API’yi içermiyor: gövde, kilidi açan planı upgrade_to alanında taşır.
  • 429 — bu pencerede bütçe tükendi: retry_after_seconds kadar bekleyin ve artan bekleyişle yeniden deneyin.

Sırada ne var?

Referansın tamamına göz atın, her uç noktayı çevrimiçi deneyin ve Zapier’i ya da aracınızı MCP üzerinden bağlayın.

API referansı →