A universally unique identifier (UUID) is a 128-bit label used for information in computer systems. When generated according to the standard methods, UUIDs are, for practical purposes, unique.
Thus, anyone can create a UUID and use it to identify something with near certainty that the identifier does not duplicate one that has already been, or will be, created to identify something else.
As an alternative to the record number (id), data records in enterprise can also be identified, read out and further processed (e.g. in URLs or databases) via uuid. For addresses and estates, there is the field uuid, which contains one UUID per record for unique identification. The uuid is automatically generated when the data record is created and is then unchangeable.
External tools can use the UUIDs to retrieve address and property data records (e.g. in a URL) without the end user being able to manipulate the parameters to access other data records.
Use case:
The UUIDs can be queried via the API calls “Read address” and “Read estate”. In addition, the UUID field can also be filtered via API. Example: if the UUID is used for identification in an external form, the internal ID for the UUID is queried once via a filter and then worked with. Then only the UUIDs can be used as URL parameters on the form page.
Request example: reading out UUIDs via address IDs
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"identifier": "",
"resourcetype": "address",
"parameters": {
"recordids": [
469,
471,
473
],
"data": [
"uuid"
]
}
}
Response example: reading out UUIDs via address IDs
{
"status": {
"code": 200,
"errorcode": 0,
"message": "OK"
},
"response": {
"results": [
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"resourcetype": "address",
"cacheable": true,
"identifier": "",
"data": {
"meta": {
"cntabsolute": 3
},
"records": [
{
"id": 469,
"type": "address",
"elements": {
"id": 469,
"uuid": "218506a8-df13-411a-b61b-8d0cd5215e27"
}
},
{
"id": 471,
"type": "address",
"elements": {
"id": 471,
"uuid": "a3a9741f-442c-42aa-a013-49d32f7f52e0"
}
},
{
"id": 473,
"type": "address",
"elements": {
"id": 473,
"uuid": "16edf071-97a8-4d81-b880-62e1e82f1f85"
}
}
]
},
"status": {
"errorcode": 0,
"message": "OK"
}
}
]
}
}
Request example: filter address IDs via UUIDs
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"identifier": "",
"resourcetype": "address",
"parameters": {
"filter": {
"uuid": [
{
"op": "IN",
"val": [
"a3a9741f-442c-42aa-a013-49d32f7f52e0",
"218506a8-df13-411a-b61b-8d0cd5215e27",
"16edf071-97a8-4d81-b880-62e1e82f1f85"
]
}
]
},
"data": [
"uuid"
]
}
}
Response example: filter address IDs via UUIDs
{
"status": {
"code": 200,
"errorcode": 0,
"message": "OK"
},
"response": {
"results": [
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"resourcetype": "address",
"cacheable": true,
"identifier": "",
"data": {
"meta": {
"cntabsolute": 3
},
"records": [
{
"id": 469,
"type": "address",
"elements": {
"id": 469,
"uuid": "218506a8-df13-411a-b61b-8d0cd5215e27"
}
},
{
"id": 471,
"type": "address",
"elements": {
"id": 471,
"uuid": "a3a9741f-442c-42aa-a013-49d32f7f52e0"
}
},
{
"id": 473,
"type": "address",
"elements": {
"id": 473,
"uuid": "16edf071-97a8-4d81-b880-62e1e82f1f85"
}
}
]
},
"status": {
"errorcode": 0,
"message": "OK"
}
}
]
}
}
Request example: reading out UUIDs via estate IDs
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"identifier": "",
"resourcetype": "estate",
"parameters": {
"data": [
"uuid"
],
"filter": {
"Id": [
{
"op": "IN",
"val": [
1663,
1647,
10825
]
}
]
}
}
}
Response example: reading out UUIDs via estate IDs
{
"status": {
"code": 200,
"errorcode": 0,
"message": "OK"
},
"response": {
"results": [
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"resourcetype": "estate",
"cacheable": true,
"identifier": "",
"data": {
"meta": {
"cntabsolute": 3
},
"records": [
{
"id": 1647,
"type": "estate",
"elements": {
"uuid": "31c83266-c452-43e1-9c99-5681d1cacba7"
}
},
{
"id": 1663,
"type": "estate",
"elements": {
"uuid": "bad1b5ce-f2a0-4ad6-8dc1-26e865f2c415"
}
},
{
"id": 10825,
"type": "estate",
"elements": {
"uuid": "0e053d5f-c1e9-4c5a-ae2a-a2e689556db3"
}
}
]
},
"status": {
"errorcode": 0,
"message": "OK"
}
}
]
}
}
Request example: filter estate IDs via UUIDs
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"identifier": "",
"resourcetype": "estate",
"parameters": {
"data": [
"uuid"
],
"filter": {
"uuid": [
{
"op": "IN",
"val": [
"bad1b5ce-f2a0-4ad6-8dc1-26e865f2c415",
"0e053d5f-c1e9-4c5a-ae2a-a2e689556db3",
"31c83266-c452-43e1-9c99-5681d1cacba7"
]
}
]
}
}
}
Response example: filter estate IDs via UUIDs
{
"status": {
"code": 200,
"errorcode": 0,
"message": "OK"
},
"response": {
"results": [
{
"actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:read",
"resourceid": "",
"resourcetype": "estate",
"cacheable": true,
"identifier": "",
"data": {
"meta": {
"cntabsolute": 3
},
"records": [
{
"id": 1647,
"type": "estate",
"elements": {
"uuid": "31c83266-c452-43e1-9c99-5681d1cacba7"
}
},
{
"id": 1663,
"type": "estate",
"elements": {
"uuid": "bad1b5ce-f2a0-4ad6-8dc1-26e865f2c415"
}
},
{
"id": 10825,
"type": "estate",
"elements": {
"uuid": "0e053d5f-c1e9-4c5a-ae2a-a2e689556db3"
}
}
]
},
"status": {
"errorcode": 0,
"message": "OK"
}
}
]
}
}