Sleamhnú go príomh-ábhar

Aitheantóirí REST agus Aitheantóirí GraphQL

Tá dhá API ag Legalesign — REST agus GraphQL — agus úsáidtear formáid ID difriúil ag gach ceann acu. Is é an comhaitheoir bunúsach céanna sna dá chás; is í an fhormáid amháin a bhaineann le chéile, mar sin is féidir iad a thiontú idir a chéile. Tá na dhá chomhéadan gréasáin seo léirithe go díreach.

Cén chomhéadan a úsáideann cén ID​

ComhéadanFo-dhomainFormáid ID
Seinnteoir oidhreachtaapp1.legalesign.comUUIDanna REST
Seinnteoir reathaconsole.legalesign.comIDanna GraphQL (base64-encoded)

Má tá tú ag obair leis an REST API, bain úsáid as na IDanna atá le feiceáil i app1. Má tá tú ag obair leis an GraphQL API, bain úsáid as na IDanna atá le feiceáil i console.

IDanna REST​

Is plain UUIDanna iad IDanna REST, mar shampla:

e6b23ca1-8443-416d-8319-c80a0afa2002

IDanna GraphQL​

Is sreanga base64-dhéanta iad IDanna GraphQL atá tógtha ó réamhtheideal ruda 3-charachtar agus an UUID bunúsach:

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

Réamhtheachtaí coitianta:

RudRéamhtheideal
Doiciméaddoc
Grúpagrp
Faighteoirrec
Teimpléadtpl
Rólrol

Ag tiontú idir formáidí​

UUID REST → ID GraphQL​

Cuir réamhtheideal an rud leis an UUID agus déan é a base64-encoding:

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

ID GraphQL → UUID REST​

Díchoigeartaigh an téacs base64 agus bain na chéad 3 charachtar:

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.