Ταυτότητες REST και Ταυτότητες GraphQL
Η Legalesign διαθέτει δύο API — REST και GraphQL — και το καθένα χρησιμοποιεί διαφορετική μορφή ταυτότητας. Ο υποκείμενος αναγνωριστικός κωδικός είναι ο ίδιος και στις δύο περιπτώσεις· μόνο η μορφή διαφέρει, ώστε να μπορούν να μετατρέπονται μεταξύ τους. Οι δύο διαδικτυακές διεπαφές το αντανακλούν άμεσα.
Ποια διεπαφή χρησιμοποιεί ποια ταυτότητα
| Διεπαφή | Υποτομέας | Μορφή ταυτότητας |
|---|---|---|
| Παλιό κονσόλα | app1.legalesign.com | REST UUIDs |
| Τρέχουσα κονσόλα | console.legalesign.com | GraphQL IDs (κωδικοποιημένα σε base64) |
Αν εργάζεστε με το REST API, χρησιμοποιήστε τις ταυτότητες που εμφανίζονται στο app1. Αν εργάζεστε με το GraphQL API, χρησιμοποιήστε τις ταυτότητες που εμφανίζονται στο console.
REST ταυτότητες
Οι REST ταυτότητες είναι απλά UUID, για παράδειγμα:
e6b23ca1-8443-416d-8319-c80a0afa2002
GraphQL ταυτότητες
Οι GraphQL ταυτότητες είναι συμβολοσειρές κωδικοποιημένες σε base64, που αποτελούνται από ένα τριψήφιο πρόθεμα αντικειμένου και το υποκείμενο UUID:
doc + e6b23ca1-8443-416d-8319-c80a0afa2002 → base64 → ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy
Συχνά προθέματα:
| Αντικείμενο | Πρόθεμα |
|---|---|
| Έγγραφο | doc |
| Ομάδα | grp |
| Παραλήπτης | rec |
| Πρότυπο | tpl |
| Ρόλος | rol |
Μετατροπή μεταξύ μορφών
REST UUID → GraphQL ταυτότητα
Προσθέστε το πρόθεμα αντικειμένου στο UUID και κωδικοποιήστε το αποτέλεσμα σε base64:
btoa("doc" + "e6b23ca1-8443-416d-8319-c80a0afa2002")
// "ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy"
GraphQL ταυτότητα → REST UUID
Αποκωδικοποιήστε τη συμβολοσειρά base64 και αφαιρέστε τους πρώτους 3 χαρακτήρες:
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"