Първото Ви повикване за пет минути

От нула до сесия на живо, създадена по API, без да напускате тази страница.

Преди да започнете

  • Акаунт с платен план: API не е част от FREE (пълният справочник все пак може да се разгледа без плащане).
  • Презентация в работното Ви пространство: сесията, която ще създадете, стартира съществуваща презентация.

  1. Създайте своите идентификационни данни

    В работното си пространство отворете Организация → API и създайте идентификационни данни с правото content:write. Тайният ключ се показва веднъж: запазете го.

    Вземете своя API ключ

    Идентификационните данни принадлежат на организацията, не на потребителя Ви: всеки администратор може да ги отнеме и всяко ползване се записва в одитния дневник. Искайте само правата, от които се нуждаете — results:read за четене, content:write за създаване и водене.

  2. Създайте и отворете сесия

    С ключа си в заглавката X-API-Key създайте сесия върху съществуваща презентация и я отворете.

    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_…"

    Сесията се ражда в състояние DRAFT; отварянето ѝ издава нейния join_code и залата е готова. Следете заглавките X-RateLimit-* в отговора: те пътуват с всеки отговор и Ви казват колко бюджет за заявки остава в прозореца от 60 секунди.

  3. Получете резултатите

    Регистрирайте webhook за question.results.finalized и получавайте подписани обобщения в своя сървър.

    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"] }'

    Запазете signing_secret, който регистрацията връща: показва се веднъж и именно той Ви позволява да проверявате всяко доставяне. Ръководството за webhooks дава готова за поставяне проверка на три езика.

Ако нещо не изглежда наред

  • 401 — липсва заглавката X-API-Key или правото: тялото назовава точно кое в required_scope.
  • 402 — планът Ви не включва API: тялото носи upgrade_to с плана, който го отключва.
  • 429 — бюджетът за този прозорец е изчерпан: изчакайте retry_after_seconds и опитайте пак с нарастващо изчакване.

Какво следва?

Разгледайте пълния справочник, изпробвайте всяка крайна точка онлайн и свържете Zapier или своя агент чрез MCP.

Справочник за API →