IDs REST et IDs GraphQL
Legalesign dispose de deux API — REST et GraphQL — et chacune utilise un format d’ID différent. L’identifiant sous-jacent est le même dans les deux cas ; seul le format diffère, ce qui permet de les convertir l’un en l’autre. Les deux interfaces web reflètent cela directement.
Quelle interface utilise quel ID
| Interface | Sous-domaine | Format d’ID |
|---|---|---|
| Console héritée | app1.legalesign.com | UUIDs REST |
| Console actuelle | console.legalesign.com | IDs GraphQL (encodés en base64) |
Si vous travaillez avec l’API REST, utilisez les IDs visibles dans app1. Si vous travaillez avec l’API GraphQL, utilisez les IDs visibles dans console.
IDs REST
Les IDs REST sont des UUIDs simples, par exemple :
e6b23ca1-8443-416d-8319-c80a0afa2002
IDs GraphQL
Les IDs GraphQL sont des chaînes encodées en base64 construites à partir d’un préfixe d’objet de 3 caractères et de l’UUID sous-jacent :
doc + e6b23ca1-8443-416d-8319-c80a0afa2002 → base64 → ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy
Préfixes courants :
| Objet | Préfixe |
|---|---|
| Document | doc |
| Groupe | grp |
| Destinataire | rec |
| Modèle | tpl |
| Rôle | rol |
Conversion entre formats
UUID REST → ID GraphQL
Préfixez l’UUID avec le préfixe d’objet puis encodez le résultat en base64 :
btoa("doc" + "e6b23ca1-8443-416d-8319-c80a0afa2002")
// "ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy"
ID GraphQL → UUID REST
Décodez la chaîne base64 et retirez les 3 premiers caractères :
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"