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
| Ryngwyneb | Is-waithdom | Fformat ID |
|---|---|---|
| Consol hen arddull | app1.legalesign.com | UUIDau REST |
| Consol cyfredol | console.legalesign.com | IDau 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:
| Gwrthrych | Rhagddodiad |
|---|---|
| Dogfen | doc |
| Grŵp | grp |
| Derbynnydd | rec |
| Templed | tpl |
| Rôl | rol |
Trosi rhwng fformatau
REST UUID → ID GraphQL
Ychwanegwch y rhagddodiad wrth y UUID a choda'r canlyniad yn base64:
btoa("doc" + "e6b23ca1-8443-416d-8319-c80a0afa2002")
// "ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy"
ID GraphQL → REST UUID
Dadgodwch y llinyn base64 a thynnwch y tri nod cyntaf:
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"