REST-IDs und GraphQL-IDs
Legalesign hat zwei APIs — REST und GraphQL — und jede verwendet ein anderes ID-Format. Der zugrunde liegende Bezeichner ist in beiden Fällen derselbe; nur das Format unterscheidet sich, sodass sie ineinander umgewandelt werden können. Die beiden Weboberflächen spiegeln dies direkt wider.
Welche Oberfläche verwendet welche ID
| Oberfläche | Subdomain | ID-Format |
|---|---|---|
| Alte Konsole | app1.legalesign.com | REST UUIDs |
| Aktuelle Konsole | console.legalesign.com | GraphQL IDs (base64-kodiert) |
Wenn Sie mit der REST API arbeiten, verwenden Sie die in app1 sichtbaren IDs. Wenn Sie mit der GraphQL API arbeiten, verwenden Sie die in console sichtbaren IDs.
REST IDs
REST IDs sind einfache UUIDs, zum Beispiel:
e6b23ca1-8443-416d-8319-c80a0afa2002
GraphQL IDs
GraphQL IDs sind base64-kodierte Zeichenketten, die aus einem 3-stelligen Objektpräfix und der zugrunde liegenden UUID zusammengesetzt sind:
doc + e6b23ca1-8443-416d-8319-c80a0afa2002 → base64 → ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy
Übliche Präfixe:
| Objekt | Präfix |
|---|---|
| Dokument | doc |
| Gruppe | grp |
| Empfänger | rec |
| Vorlage | tpl |
| Rolle | rol |
Umwandlung zwischen Formaten
REST UUID → GraphQL ID
Fügen Sie dem UUID das Objektpräfix voran und kodieren Sie das Ergebnis base64:
btoa("doc" + "e6b23ca1-8443-416d-8319-c80a0afa2002")
// "ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy"
GraphQL ID → REST UUID
Dekodieren Sie die base64-Zeichenkette und entfernen Sie die ersten 3 Zeichen:
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"