IDs REST e IDs GraphQL
Legalesign tiene dos APIs — REST y GraphQL — y cada una usa un formato de ID diferente. El identificador subyacente es el mismo en ambos casos; solo cambia el formato, por lo que pueden convertirse entre sí. Las dos interfaces web reflejan esto directamente.
Which interface uses which ID
| Interface | Subdominio | Formato de ID |
|---|---|---|
| Consola antigua | app1.legalesign.com | UUIDs REST |
| Consola actual | console.legalesign.com | IDs GraphQL (codificados en base64) |
Si estás trabajando con la API REST, usa los IDs visibles en app1. Si trabajas con la API GraphQL, utiliza los IDs visibles en console.
REST IDs
Los IDs REST son UUIDs simples, por ejemplo:
e6b23ca1-8443-416d-8319-c80a0afa2002
GraphQL IDs
Los IDs GraphQL son cadenas codificadas en base64 construidas a partir de un prefijo de objeto de 3 caracteres y el UUID subyacente:
doc + e6b23ca1-8443-416d-8319-c80a0afa2002 → base64 → ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy
Prefijos comunes:
| Objeto | Prefijo |
|---|---|
| Documento | doc |
| Grupo | grp |
| Destinatario | rec |
| Plantilla | tpl |
| Rol | rol |
Convirtiendo entre formatos
REST UUID → GraphQL ID
Prefija el UUID con el prefijo del objeto y codifica el resultado en base64:
btoa("doc" + "e6b23ca1-8443-416d-8319-c80a0afa2002")
// "ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy"
GraphQL ID → REST UUID
Decodifica la cadena base64 y elimina los primeros 3 caracteres:
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"