Vai al contenuto principale

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​

InterfacciaSottodominioFormato ID
Console legacyapp1.legalesign.comUUID REST
Console attualeconsole.legalesign.comID 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:

OggettoPrefisso
Documentodoc
Gruppogrp
Destinatariorec
Modellotpl
Ruolorol

Conversione tra formati​

UUID REST → ID GraphQL​

Prenfissa l'UUID con il prefisso oggetto e codifica il risultato in base64:

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

ID GraphQL → UUID REST​

Decodifica la stringa base64 ed elimina i primi 3 caratteri:

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

Export This Article

Save a copy of this page as PDF or plain text.