Leum gu prìomh susbaint

Aitheantan REST agus Aitheantan GraphQL

Tha dà APIs aig Legalesign — REST agus GraphQL — agus bidh gach fear a’ cleachdadh cruth ID eadar-dhealaichte. Tha an dearbh-aithne fon uachdar an aon rud anns an dà chùis; is e a-mhàin an cruth a tha eadar-dhealaichte, agus mar sin faodar an tionndadh eadar chèile. Tha na dà eadar-aghaidh lìn a’ sealltainn seo gu dìreach.

Dè an eadar-aghaidh a tha a’ cleachdadh dè an ID​

Eadar-aghaidhFo-dhomainCruth ID
Console seann-fhasantaapp1.legalesign.comREST UUIDan
Console làithreachconsole.legalesign.comIDs GraphQL (còd base64)

Ma tha thu ag obair leis a’ REST API, cleachd na h-IDs a chì thu ann an app1. Ma tha thu ag obair leis a’ GraphQL API, cleachd na h-IDs a chì thu ann an console.

IDs REST​

Tha IDs REST nan UUIDan sìmplidh, mar eisimpleir:

e6b23ca1-8443-416d-8319-c80a0afa2002

IDs GraphQL​

Tha IDs GraphQL nan sreathan air an còdachadh ann am base64, air an togail bho ro-ríomh 3-charactair an t-àrd-uidhe agus an UUID fon uachdar:

doc + e6b23ca1-8443-416d-8319-c80a0afa2002  →  base64  →  ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy

Ro-riochdan cumanta:

NìRo-rìomh
Sgrìobhainndoc
Buidheanngrp
Fastaicherec
Teamplaidtpl
Dreuchdrol

A’ tionndadh eadar cruthan​

REST UUID → ID GraphQL​

Cuir ro-ríomh an t-àrd-uidhe ris an UUID agus còdaich am freagairt ann am base64:

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

ID GraphQL → REST UUID​

Dé-còdaich an sreang base64 agus thoir air falbh na 3 caractaran a th’ an toiseach:

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