Dvina MCP

Χρησιμοποιήστε την πρόσβαση API

Δημιουργήστε προσωπικά διακριτικά πρόσβασης για scripts και προγράμματα-πελάτες MCP και στείλτε τα συμβάντα του Livespace σας στα δικά σας συστήματα με webhooks.

Προβολή ως Markdown

Στις Ρυθμίσεις › Πρόσβαση API, δημιουργείτε προσωπικά διακριτικά πρόσβασης, ώστε ένα script ή ένα πρόγραμμα-πελάτης MCP να μπορεί να χρησιμοποιεί το Dvina εκ μέρους σας. Εκεί οι διαχειριστές προσθέτουν επίσης webhooks, για να στέλνουν τα συμβάντα του Livespace στα δικά τους συστήματα.

Η πρόσβαση API περιλαμβάνεται στο πλάνο Enterprise. Κάθε μέλος μπορεί να δημιουργεί τα δικά του διακριτικά. Μόνο οι κάτοχοι και οι διαχειριστές βλέπουν την ενότητα Webhooks.

Δημιουργήστε ένα διακριτικό

  1. Ανοίξτε τις Ρυθμίσεις και επιλέξτε Πρόσβαση API.
  2. Στην ενότητα Προσωπικά διακριτικά πρόσβασης, επιλέξτε Δημιουργία διακριτικού.
  3. Εισαγάγετε ένα Όνομα, ώστε να γνωρίζετε αργότερα τι το χρησιμοποιεί.
  4. Επιλέξτε την Πρόσβαση: Μόνο ανάγνωση ή Ανάγνωση και εγγραφή.
  5. Επιλέξτε πότε Λήγει: Σε 30 ημέρες, Σε 90 ημέρες, Σε 365 ημέρες ή Δεν λήγει ποτέ.
  6. Επιλέξτε Δημιουργία διακριτικού.
  7. Στην ενότητα Αντιγράψτε το διακριτικό σας, αντιγράψτε το διακριτικό και φυλάξτε το σε ασφαλές μέρος. Αυτή είναι η μόνη φορά που εμφανίζεται.

Το διακριτικό ενεργεί εκ μέρους σας, στο Livespace όπου το δημιουργήσατε, με τον ρόλο που έχετε εκεί τη δεδομένη στιγμή. Ένα διακριτικό Μόνο ανάγνωση μπορεί να διαβάζει, αλλά δεν μπορεί να προσθέτει ή να αλλάζει τίποτα.

Για να χρησιμοποιήσετε ένα διακριτικό με ένα πρόγραμμα-πελάτης MCP, δείτε την ενότητα Σύνδεση με κλειδί API αντί για OAuth.

Ελέγξτε, αντικαταστήστε ή ανακαλέστε ένα διακριτικό

Τα διακριτικά σας εμφανίζονται στην ενότητα Προσωπικά διακριτικά πρόσβασης, μαζί με την πρόσβαση που παρέχουν. Επιλέξτε ένα για να δείτε με ποιους χαρακτήρες Ξεκινά, την Πρόσβαση που παρέχει, πότε έγινε η Τελευταία χρήση και πότε Λήγει.

  • Για να αντικαταστήσετε ένα διακριτικό, επιλέξτε Αντικατάσταση… και έπειτα Αντικατάσταση για επιβεβαίωση. Ένα νέο διακριτικό το αντικαθιστά και το παλιό σταματά αμέσως να λειτουργεί. Αντιγράψτε το νέο διακριτικό στην ενότητα Αντιγράψτε το διακριτικό σας.
  • Για να απενεργοποιήσετε ένα διακριτικό, επιλέξτε Ανάκληση… και έπειτα Ανάκληση για επιβεβαίωση. Οτιδήποτε το χρησιμοποιεί σταματά αμέσως να λειτουργεί.

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

Προσθέστε ένα webhook

Ένα webhook στέλνει τα συμβάντα του Livespace —τις ίδιες εγγραφές με το αρχείο καταγραφής ελέγχου— σε μια διεύθυνση που επιλέγετε.

  1. Στις Ρυθμίσεις › Πρόσβαση API, στην ενότητα Webhooks, επιλέξτε Προσθήκη webhook.
  2. Εισαγάγετε ένα Όνομα και το URL. Χρησιμοποιήστε ένα δημόσιο URL HTTPS.
  3. Στην ενότητα Συμβάντα, αφήστε το πεδίο κενό για να λαμβάνετε όλα τα συμβάντα ή καταχωρίστε ενέργειες και περιοχές, όπως member.added ή sharing.*.
  4. Επιλέξτε Προσθήκη.
  5. Στην ενότητα Αντιγράψτε το μυστικό υπογραφής, αντιγράψτε το μυστικό. Αυτή είναι η μόνη φορά που εμφανίζεται.

Αν το Dvina εμφανίσει το μήνυμα Αυτή η διεύθυνση δεν είναι προσβάσιμη από το Dvina, χρησιμοποιήστε ένα δημόσιο URL HTTPS.

Ελέγξτε την υπογραφή κάθε αιτήματος

Το Dvina στέλνει συμβάντα σε παρτίδες, σε μορφή JSON, και υπογράφει κάθε αίτημα. Χρησιμοποιήστε το μυστικό υπογραφής για να ελέγξετε ότι ένα αίτημα προήλθε από το Dvina:

  • Κάθε αίτημα έχει μια κεφαλίδα X-Dvina-Signature της μορφής t=<timestamp>,v1=<signature>.
  • Η υπογραφή είναι ένα HMAC-SHA256, σε δεκαεξαδική μορφή, που υπολογίζεται από τη χρονική σήμανση, μια τελεία και το σώμα του αιτήματος, με το μυστικό υπογραφής σας.
  • Υπολογίστε την υπογραφή μόνοι σας και συγκρίνετέ την. Απορρίψτε ένα αίτημα αν η υπογραφή του δεν ταιριάζει ή αν η χρονική του σήμανση είναι πολύ παλιά.

Ελέγξτε ή αλλάξτε ένα webhook

Τα webhooks σας εμφανίζονται στην ενότητα Webhooks με την κατάστασή τους: Ενεργό, Σε παύση ή Αποτυγχάνει. Επιλέξτε ένα για να δείτε τις λεπτομέρειές του.

  • Για να το αλλάξετε, επεξεργαστείτε το Όνομα, το URL ή τα Συμβάντα και επιλέξτε Αποθήκευση.
  • Για να το θέσετε σε παύση, απενεργοποιήστε την Αποστολή συμβάντων. Ενεργοποιήστε την ξανά για να συνεχιστεί η αποστολή.
  • Για να δείτε πώς λειτουργεί, ελέγξτε την Κατάστασή του και πόσα συμβάντα Στάλθηκαν. Αν ένα webhook αποτυγχάνει, εμφανίζει το Τελευταίο σφάλμα του. Το Dvina συνεχίζει τις προσπάθειες και καταγράφει την αποτυχία στο αρχείο καταγραφής ελέγχου.
  • Για να αλλάξετε το μυστικό του, επιλέξτε Νέο μυστικό υπογραφής… και επιβεβαιώστε. Τα αιτήματα υπογράφονται αμέσως με το νέο μυστικό, οπότε ενημερώστε αμέσως τον παραλήπτη.
  • Για να το καταργήσετε, επιλέξτε Διαγραφή… και έπειτα Διαγραφή για επιβεβαίωση. Δεν αποστέλλεται πλέον τίποτα σε αυτό.