Μετάβαση στο κύριο περιεχόμενο

Ταυτότητες REST και Ταυτότητες GraphQL

Η Legalesign διαθέτει δύο API — REST και GraphQL — και το καθένα χρησιμοποιεί διαφορετική μορφή ταυτότητας. Ο υποκείμενος αναγνωριστικός κωδικός είναι ο ίδιος και στις δύο περιπτώσεις· μόνο η μορφή διαφέρει, ώστε να μπορούν να μετατρέπονται μεταξύ τους. Οι δύο διαδικτυακές διεπαφές το αντανακλούν άμεσα.

Ποια διεπαφή χρησιμοποιεί ποια ταυτότητα​

ΔιεπαφήΥποτομέαςΜορφή ταυτότητας
Παλιό κονσόλαapp1.legalesign.comREST UUIDs
Τρέχουσα κονσόλαconsole.legalesign.comGraphQL 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:

Node.js / browser
btoa("doc" + "e6b23ca1-8443-416d-8319-c80a0afa2002")
// "ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy"

GraphQL ταυτότητα → REST UUID​

Αποκωδικοποιήστε τη συμβολοσειρά base64 και αφαιρέστε τους πρώτους 3 χαρακτήρες:

Node.js / browser
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"