ID REST e ID GraphQL
Legalesign ha due API — REST e GraphQL — e ciascuna utilizza un formato ID diverso. L'identificatore sottostante è lo stesso in entrambi i casi; cambia solo il formato, quindi possono essere convertiti l'uno nell'altro. Le due interfacce web riflettono questo direttamente.
Quale interfaccia usa quale ID
| Interfaccia | Sottodominio | Formato ID |
|---|---|---|
| Console legacy | app1.legalesign.com | UUID REST |
| Console attuale | console.legalesign.com | ID GraphQL (codificati base64) |
Se stai lavorando con l'API REST, usa gli ID visibili in app1. Se stai lavorando con l'API GraphQL, usa gli ID visibili in console.
ID REST
Gli ID REST sono UUID semplici, per esempio:
e6b23ca1-8443-416d-8319-c80a0afa2002
ID GraphQL
Gli ID GraphQL sono stringhe codificate in base64 costruite da un prefisso oggetto di 3 caratteri e dall'UUID sottostante:
doc + e6b23ca1-8443-416d-8319-c80a0afa2002 → base64 → ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy
Prefissi comuni:
| Oggetto | Prefisso |
|---|---|
| Documento | doc |
| Gruppo | grp |
| Destinatario | rec |
| Modello | tpl |
| Ruolo | rol |
Conversione tra formati
UUID REST → ID GraphQL
Prenfissa l'UUID con il prefisso oggetto e codifica il risultato in base64:
btoa("doc" + "e6b23ca1-8443-416d-8319-c80a0afa2002")
// "ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy"
ID GraphQL → UUID REST
Decodifica la stringa base64 ed elimina i primi 3 caratteri:
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"