Saltar al contenido principal

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​

InterfaceSubdominioFormato de ID
Consola antiguaapp1.legalesign.comUUIDs REST
Consola actualconsole.legalesign.comIDs 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:

ObjetoPrefijo
Documentodoc
Grupogrp
Destinatariorec
Plantillatpl
Rolrol

Convirtiendo entre formatos​

REST UUID → GraphQL ID​

Prefija el UUID con el prefijo del objeto y codifica el resultado en base64:

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

GraphQL ID → REST UUID​

Decodifica la cadena base64 y elimina los primeros 3 caracteres:

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.