Πρόσβαση και έλεγχος ταυτότητας API

Το SPREEAI παρέχει μια δημόσια αναφορά API για εγκεκριμένες ροές εργασίας συνεργατών: https://docs.spreeai.com/swagger/public/.

Μοντέλο πρόσβασης

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

Κανόνες διαπιστευτηρίων

• Αποθηκεύστε τα μυστικά των πελατών και τα διακριτικά πρόσβασης μόνο σε ένα ασφαλές μυστικό χώρο αποθήκευσης στην πλευρά του διακομιστή.
• Ποτέ μην δεσμεύετε διαπιστευτήρια σε Git, τεκμηρίωση, προγράμματα παρακολούθησης προβλημάτων, στιγμιότυπα οθόνης ή δείγματα εφαρμογών.
• Μην στέλνετε ποτέ διαπιστευτήρια σε πλατφόρμες ανάλυσης ή καταγραφής.
• Χρησιμοποιήστε διαπιστευτήρια ειδικά για το περιβάλλον μόνο με το περιβάλλον για το οποίο εκδόθηκαν.
• Εναλλάξτε αμέσως ένα διαπιστευτήριο εάν είναι εκτεθειμένο.
• Διαγράψτε τις κεφαλίδες και τα διακριτικά εξουσιοδότησης από τα αιτήματα υποστήριξης.

Πρόγραμμα περιήγησης έναντι διακομιστή

Το Web SDK χρησιμοποιεί διαμόρφωση προγράμματος περιήγησης που έχει εκδοθεί από συνεργάτη. Δεν πρέπει να περιλαμβάνεται μυστικό στοιχείο προγράμματος-πελάτη στο πρόγραμμα περιήγησης.

Οι ενσωματώσεις από την πλευρά του διακομιστή θα πρέπει να ακολουθούν τη ροή ελέγχου ταυτότητας και τους ορισμούς τελικού σημείου στην τρέχουσα εγκεκριμένη αναφορά API. Όταν απουσιάζει μια απαραίτητη λειτουργία, ζητήστε την μέσω του Partner Engineering αντί να δημιουργήσετε μια μη τεκμηριωμένη διαδρομή.

Ιστοσελίδες

Τα webhooks που ωθούν τον διακομιστή δεν αποτελούν μέρος της τρέχουσας δημοσιευμένης τεκμηρίωσης του Web SDK. Επιβεβαιώστε οποιαδήποτε απαίτηση webhook πριν σχεδιάσετε μια εξάρτηση σε αυτήν.

Λίστα ελέγχου για το περιβάλλον

• [ ] Το όνομα του περιβάλλοντος είναι τεκμηριωμένο.
• [ ] Η βασική διεύθυνση URL προήλθε από την εγκεκριμένη αναφορά ή την παράδοση ενσωμάτωσης.
• [ ] Εκδόθηκαν πιστοποιήσεις για αυτό το περιβάλλον.
• [ ] Τα μυστικά αποθηκεύονται στην πλευρά του διακομιστή.
• [ ] Τα αρχεία καταγραφής επεξεργάζονται διακριτικά και εικόνες πελατών.
• [ ] Έχουν συμφωνηθεί χρονικά όρια, επαναλήψεις και συμπεριφορά ταυτοδυναμίας για τις λειτουργίες εγγραφής.
• [ ] Μια δοκιμή εκτός παραγωγής ολοκληρώνεται με επιτυχία πριν χρησιμοποιηθεί η πρόσβαση παραγωγής.