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éadan | Fo-dhomain | Formáid ID |
|---|---|---|
| Seinnteoir oidhreachta | app1.legalesign.com | UUIDanna REST |
| Seinnteoir reatha | console.legalesign.com | IDanna 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:
| Rud | Réamhtheideal |
|---|---|
| Doiciméad | doc |
| Grúpa | grp |
| Faighteoir | rec |
| Teimpléad | tpl |
| Ról | rol |
Ag tiontú idir formáidí
UUID REST → ID GraphQL
Cuir réamhtheideal an rud leis an UUID agus déan é a base64-encoding:
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:
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"