Mετάβαση στο κύριο περιεχόμενο
Ξεκινώντας με το Webex Events API

Τι κάνει το API και πώς να ξεκινήσετε

Daniel Murphey avatar
Συντάχθηκε από: Daniel Murphey
Ενημερώθηκε πριν από περισσότερο από μία εβδομάδα

Αυτό το άρθρο μεταφράστηκε από τα αγγλικά χρησιμοποιώντας αυτόματη μετάφραση.

Εάν έχετε έναν προγραμματιστή στην ομάδα σας που ξέρει πώς να χρησιμοποιεί ένα GraphQL API, το Webex Events API θα μπορούσε να είναι η πύλη σας για ισχυρούς αυτοματισμούς ρύθμισης και διαχείρισης συμβάντων και προϊόντων, ενσωματώσεις πλατφορμών τρίτων, ισχυρούς πίνακες εργαλείων δεδομένων πολλών συμβάντων και πολλά άλλα .

Τι μπορεί να κάνει το Webex Events API

Με απλά λόγια, ένα API είναι μια διεπαφή προγραμματισμού που μπορούν να χρησιμοποιήσουν οι προγραμματιστές για να λάβουν δεδομένα ή να τοποθετήσουν δεδομένα σε μια διαδικτυακή πλατφόρμα — σε αυτήν την περίπτωση, Webex Events.

Οι δυνατότητες του API μπορούν να απλοποιηθούν σε τέσσερις βασικές έννοιες:

  • Δημιουργήστε κάτι που δεν υπήρχε πριν, όπως ένας συμμετέχων, μια περίοδος σύνδεσης ή μια ολόκληρη εκδήλωση.

  • Ενημερώστε οτιδήποτε μπορεί να χρησιμοποιηθεί για τη δημιουργία του API, καθώς και μερικά ακόμη πράγματα. Για παράδειγμα, το API μπορεί να χρησιμοποιηθεί για τη δημιουργία ενός νέου συμμετέχοντα και, στη συνέχεια, την επεξεργασία του ονόματος, του email, της κατάστασης, των ομάδων, των αριθμών τηλεφώνου και των λογαριασμών κοινωνικής δικτύωσης αυτού του συμμετέχοντα.

  • Διαβάστε πληροφορίες σχετικά με οτιδήποτε μπορεί να χρησιμοποιηθεί για τη δημιουργία ή την επεξεργασία του API, καθώς και ορισμένα πράγματα που δεν μπορεί να χρησιμοποιηθεί.

  • Διαγράψτε οτιδήποτε μπορεί να χρησιμοποιηθεί για τη δημιουργία του API, με ορισμένες εξαιρέσεις.

Λάβετε υπόψη αυτές τις έννοιες κατά την ανάγνωση της ενότητας «Εργασία με προγραμματιστές» αυτού του άρθρου.

Πως να ξεκινήσεις

1. Αποκτήστε πρόσβαση στο API

Εάν είστε πελάτης του Webex Suite Enterprise Agreement (Suite EA) που έχει ήδη ενεργοποιήσει τα Webex Events , αποκτάτε αυτόματα πρόσβαση στο Webex Events API! Για όλους τους άλλους πελάτες, μιλήστε με την επαφή σας στο Webex Events ή με την ομάδα υποστήριξής μας για να μάθετε σχετικά με την πρόσβαση στο API.

2. Δημιουργήστε ένα κλειδί API

Τώρα πρέπει να δημιουργήσετε ένα νέο κλειδί API για χρήση από τους προγραμματιστές σας. Όταν έχετε πρόσβαση στο API, προστίθεται μια νέα καρτέλα στη σελίδα 'Ρυθμίσεις οργάνωσης' στην πλατφόρμα Webex Events . Δείτε πώς μπορείτε να αποκτήσετε πρόσβαση στη νέα καρτέλα και να δημιουργήσετε το πρώτο σας κλειδί:

💡 Λάβετε υπόψη ότι μόνο οι διαχειριστές οργανισμού μπορούν να έχουν πρόσβαση στη σελίδα API.

  1. Από οπουδήποτε στην πλατφόρμα Webex Events , κάντε κλικ στην εικόνα του προφίλ σας στην επάνω δεξιά γωνία της οθόνης και, στη συνέχεια, επιλέξτε Ρυθμίσεις οργανισμού από το αναπτυσσόμενο μενού.

  2. Στη σελίδα ρυθμίσεων οργάνωσης, κάντε κλικ στην καρτέλα API στο αριστερό μενού. Αυτό σας οδηγεί στον πίνακα ελέγχου API όπου μπορείτε να ελέγξετε τη χρήση του API, να εξάγετε αρχεία καταγραφής χρήσης, να διαχειριστείτε κλειδιά και να αποκτήσετε πρόσβαση στην τεκμηρίωση του API.

  3. Κάντε κλικ στην επιλογή Δημιουργία κλειδιού .

  4. Στο modal "Δημιουργία νέου κλειδιού" εισαγάγετε μια ετικέτα για το κλειδί API που εξηγεί σε τι θα χρησιμοποιηθεί.

  5. Το αναπτυσσόμενο μενού έκδοσης API θα έχει ήδη επιλεγμένη την τρέχουσα έκδοση, επομένως απλώς κάντε κλικ στην Αποθήκευση . Αυτό αποκαλύπτει το κλειδί API.

  6. Κάντε κλικ στο κουμπί Αντιγραφή δίπλα στο κλειδί και επικολλήστε το κλειδί σε ένα ασφαλές έγγραφο για να βεβαιωθείτε ότι δεν θα χαθεί ποτέ.

    ⚠️ ΠΡΟΕΙΔΟΠΟΙΗΣΗ! Αυτή είναι η μόνη φορά που είναι δυνατή η πρόσβαση στο πλήρες κλειδί API. Αφού κλείσετε το modal, το πλήρες κλειδί δεν μπορεί να διαβαστεί ξανά.

  7. Αφού αντιγράψετε και αποθηκεύσετε το κλειδί, κάντε κλικ στο κουμπί Κλείσιμο .

Στις περισσότερες περιπτώσεις, χρειάζεστε μόνο ένα κλειδί API. Ωστόσο, σε περιπτώσεις όπου εργάζεστε με πολλές ομάδες, μπορεί να θέλετε να δημιουργήσετε ένα κλειδί για κάθε ομάδα. Μιλήστε με τους προγραμματιστές σας για τις συγκεκριμένες περιπτώσεις χρήσης για να βρείτε την καλύτερη λύση.

3. Προσκαλέστε προγραμματιστές να αποκτήσουν πρόσβαση στο API

Όταν δημιουργείτε το πρώτο σας κλειδί API, δημιουργείται αυτόματα μια νέα ομάδα API στην πλατφόρμα Webex Events . Το να δώσετε στους προγραμματιστές σας πρόσβαση για να δοκιμάσουν το Webex Events API είναι τόσο απλό όσο να τους προσκαλέσετε σε αυτήν την ομάδα API. Ακολουθήστε τις οδηγίες στο άρθρο μας σχετικά με τη διαχείριση ομάδων, μελών και πιστώσεων για να μάθετε πώς.

💡 Λάβετε υπόψη ότι το API sandbox είναι μια ξεχωριστή έκδοση της πλατφόρμας Webex Events που δημιουργήθηκε ειδικά για δοκιμή. Αυτό σημαίνει ότι όλα τα νέα μέλη της ομάδας API Sandbox πρέπει να δημιουργήσουν έναν νέο λογαριασμό πλατφόρμας για να χρησιμοποιούν το sandbox, ακόμα κι αν έχουν ήδη λογαριασμό πλατφόρμας ή συνδέονται με τον SSO του οργανισμού τους.

Τα άτομα στην ομάδα API σας δεν έχουν πρόσβαση στην υπόλοιπη πλατφόρμα Webex Events με τον τρόπο που έχουν οι διοργανωτές. Αντίθετα, τα μέλη της ομάδας API έχουν πρόσβαση σε ένα "sandbox" API όπου μπορούν να δοκιμάσουν αυτό που δημιουργούν χωρίς να επηρεάσουν τα δεδομένα του πραγματικού κόσμου. Εάν θέλετε οι προγραμματιστές να έχουν επίσης πρόσβαση σε ορισμένες ή όλες τις πραγματικές εκδηλώσεις και εφαρμογές σας στην πλατφόρμα Webex Events , προσκαλέστε τους σε σχετικές ομάδες που δεν ανήκουν στο API.

4. Προετοιμάστε μια εκδήλωση

Επειδή το API δεν μπορεί να ενεργοποιήσει κανένα από τα προϊόντα σε ένα συμβάν, όπως την Event App και το Onsite, πρέπει να ενεργοποιήσετε κάθε προϊόν που σκοπεύετε να χρησιμοποιήσετε στο συμβάν σας, συμπληρώνοντας τις βασικές απαιτούμενες πληροφορίες.

Συνεργασία με προγραμματιστές

Είναι σημαντικό για εσάς να επικοινωνείτε ξεκάθαρα με τους προγραμματιστές σας, ώστε να μπορούν να δημιουργήσουν αυτό που χρειάζεστε. Αυτό σημαίνει ότι πρέπει να γνωρίζετε σε ποια μέρη της πλατφόρμας Webex Events μπορεί να έχει πρόσβαση το API. Συνεχίστε να διαβάζετε για να μάθετε ακριβώς τι μπορεί να έχει πρόσβαση και να ελέγχει το API, καθώς και μερικές συμβουλές που θα σας βοηθήσουν να "μιλάτε την ίδια γλώσσα" με τον προγραμματιστή σας.

Όταν εξοικειωθείτε με τις βασικές δυνατότητες, μπορείτε να αρχίσετε να μιλάτε με τον προγραμματιστή σας σχετικά με τη δημιουργία εργαλείων και αυτοματισμών με το API.

Ομάδες και οργανισμοί

  • Δημιουργήστε, ενημερώστε, διαβάστε και διαγράψτε ομάδες και μέλη ομάδας

Εκδηλώσεις

  • Δημιουργήστε, ενημερώστε, κλωνοποιήστε και διαβάστε. Τα συμβάντα δεν μπορούν να διαγραφούν.

παρευρισκόμενοι

  • Δημιουργήστε, ενημερώστε, διαβάστε, αντιστοιχίστε σε περιόδους σύνδεσης, αντιστοιχίστε σε ομάδες και διαγράψτε πληροφορίες λογαριασμού κοινωνικής δικτύωσης (αριθμός τηλεφώνου, χειρισμοί λογαριασμών κοινωνικής δικτύωσης κ.λπ.). Οι συμμετέχοντες δεν μπορούν να διαγραφούν, αν και μπορούν να αποκλειστούν.

Ερωτήσεις

  • Δημιουργία, ενημέρωση, ανάγνωση και διαγραφή

Συμβουλή: Στο API, οι ερωτήσεις ονομάζονται "προσαρμοσμένα πεδία"

Ομάδες

  • Δημιουργήστε, ενημερώστε, διαβάστε και διαγράψτε αποκλειστικές και μη αποκλειστικές ομάδες

Συνεδρίες

  • Δημιουργία, ενημέρωση, ανάγνωση και διαγραφή

Τοποθεσίες

  • Δημιουργία, ενημέρωση, ανάγνωση και διαγραφή

Συμβουλή: Στο API, οι τοποθεσίες ονομάζονται "περιοχές".

Branded Apps

  • Διαβάστε τα ονόματα Branded App , τις καταστάσεις και τα ονόματα των εκχωρημένων συμβάντων

Event App

  • Διαβάστε τις ρυθμίσεις Βασικά, Εμφάνιση και Εφαρμογές Ιστού καθώς και πληροφορίες Εγγραφές Video Center

  • Δημιουργήστε, ενημερώστε, διαβάστε και διαγράψτε τις ακόλουθες λειτουργίες της Event App και τα στοιχεία τους, όπου ισχύει:

    • Ημερήσια διάταξη

    • Χορηγοί

    • Ηχεία

    • Εκθέτες

    • Απευθείας μετάδοση

    • παρευρισκόμενοι

    • Προσαρμοσμένη λίστα

    • Ενιαίο Στοιχείο

    • Σύνδεσμος Ιστού

    • Λίστα Ιστού

    • Ο κωδικός QR μου

💡 Λάβετε υπόψη ότι πρέπει να προσθέσετε και να διαμορφώσετε με μη αυτόματο τρόπο οποιεσδήποτε λειτουργίες της Event App που δεν αναφέρονται παραπάνω.

Συμβουλή: Στο API, οι δυνατότητες ονομάζονται "εξαρτήματα".

Εγγραφή

  • Διαβάστε τις βασικές πληροφορίες, την εμφάνιση και τις ρυθμίσεις, συμπεριλαμβανομένων των ρυθμίσεων αγοράς

  • Δημιουργήστε, διαβάστε, ενημερώστε και διαγράψτε εισιτήρια, φόρμες, ερωτήσεις, κωδικούς προσφοράς

  • Δημιουργήστε, διαβάστε και ενημερώστε παραγγελίες

  • Στείλτε email επιβεβαίωσης παραγγελίας και εισιτηρίου

  • Επισήμανση παραγγελιών επιταγών ή τιμολογίων ως πληρωμένων

  • Ενημέρωση στοιχείων αγοραστή παραγγελίας

  • Ακύρωση και επιστροφή χρημάτων εισιτηρίων

  • Δημιουργία, ανάγνωση, ενημέρωση, διαγραφή, παύση και συνέχιση κωδικών προσφοράς

  • Δημιουργήστε, διαβάστε, ενημερώστε και διαγράψτε φόρους

Συμβουλή: Στο API, οι ερωτήσεις ονομάζονται "προσαρμοσμένα πεδία".

Στην Onsite

  • Διαβάστε και ενημερώστε τα Basics και τις πληροφορίες Onsite App

Lead Retrieval και Live Display

  • Διαβάστε εάν το προϊόν είναι ενεργό ή δημοσιευμένο στην Εκδήλωση

Πράγματα που πρέπει να γνωρίζετε

  • Περιστασιακά θα κυκλοφορούμε νέες εκδόσεις του API με βελτιώσεις και διορθώσεις. Θα συνεχίσουμε να υποστηρίζουμε τις παλιές εκδόσεις για αρκετό καιρό ώστε όλοι να μπορούν να μεταβούν στη νέα έκδοση. Θα στείλουμε ενημερώσεις μέσω email σχετικά με νέες εκδόσεις, επερχόμενες ημερομηνίες κατάργησης παλαιών εκδόσεων και επίσημες καταργήσεις.

  • Τα αιτήματα API μετρώνται και περιορίζονται για την αποφυγή κατάχρησης.

  • Οι κοινότητες υποστηρίζονται επίσης για πελάτες Suite.

Απαντήθηκε η ερώτησή σας;