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-aghaidh | Fo-dhomain | Cruth ID |
|---|---|---|
| Console seann-fhasanta | app1.legalesign.com | REST UUIDan |
| Console làithreach | console.legalesign.com | IDs 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ìobhainn | doc |
| Buidheann | grp |
| Fastaiche | rec |
| Teamplaid | tpl |
| Dreuchd | rol |
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:
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:
atob("ZG9jZTZiMjNjYTEtODQ0My00MTZkLTgzMTktYzgwYTBhZmEyMDAy")
// "doce6b23ca1-8443-416d-8319-c80a0afa2002"
// strip "doc" → "e6b23ca1-8443-416d-8319-c80a0afa2002"