Neidio i’r prif gynnwys

IDs REST a IDs GraphQL

Legalesign yn cynnig dau API — REST a GraphQL — ac mae pob un yn defnyddio fformat ID gwahanol. Mae'r dynodwr sylfaenol yr un peth yn y ddau achos; dim ond y fformat sy'n wahanol, felly gellir ei drawsnewid rhyngddynt. Mae'r ddau ryngwyneb gwe yn adlewyrchu hyn yn uniongyrchol.

Pa ryngwyneb sy'n defnyddio pa ID​

RyngwynebIs-waithdomFformat ID
Consol hen arddullapp1.legalesign.comUUIDau REST
Consol cyfredolconsole.legalesign.comIDau GraphQL (codwyd yn base64)

Os ydych yn gweithio gyda'r API REST, defnyddiwch y IDau sydd yn weledol yn app1. Os ydych yn defnyddio'r API GraphQL, defnyddiwch y IDau sydd yn weledol yn console.

IDau REST​

Mae IDau REST yn UUIDau syml, er enghraifft:

e6b23ca1-8443-416d-8319-c80a0afa2002

IDau GraphQL​

Mae IDau GraphQL yn gyfansoddion wedi'u codio base64 wedi'u hadeiladu o ragddodiaid gwrthrych 3-nod a'r UUID sylfaenol:

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

Rhagddodiaid cyffredin:

GwrthrychRhagddodiad
Dogfendoc
Grŵpgrp
Derbynnyddrec
Templedtpl
Rôlrol

Trosi rhwng fformatau​

REST UUID → ID GraphQL​

Ychwanegwch y rhagddodiad wrth y UUID a choda'r canlyniad yn base64:

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

ID GraphQL → REST UUID​

Dadgodwch y llinyn base64 a thynnwch y tri nod cyntaf:

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.