Η πρώτη σας κλήση σε πέντε λεπτά

Από το μηδέν σε μια ζωντανή συνεδρία δημιουργημένη μέσω 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 και λαμβάνετε υπογεγραμμένα συγκεντρωτικά στοιχεία στο backend σας.

    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 και ξαναδοκιμάστε με προοδευτική αναμονή.

Τι ακολουθεί;

Δείτε ολόκληρη την αναφορά, δοκιμάστε κάθε σημείο πρόσβασης online και συνδέστε το Zapier ή τον πράκτορά σας μέσω MCP.

Αναφορά API →