Recleanse Entities
This operation recleanses an existing entity.
Request:
GET /{tenantId}/entities/recleanse?entityId={entityId}
Name | Required | Details |
---|---|---|
Authorization | yes | Bearer <access_token> |
Name | Required | Details |
---|---|---|
entityID |
Yes | The ID of the entity to recleanse. |
returnUserData |
No | If false, Reltio Cloud doesn't return user data provided to cleanse, only cleansed values. |
options |
No | This is comma-separated list of different options, which affect
on entity's JSON content in a response.
Available options: sendHidden - the entity's JSON will contain hidden
attributes if this option is enabled. The default is false. |
Response:
JSON Array containing an object representing the cleansed object, or in case of fuzzy cleansing variants of cleansed entity based on multiple cleansed results. Fuzzy cleansing, when cleansing provides multiple results for one input, can occur for example when user didn't specify the exact location, but provided address that corresponds to some amount of different places.
Example:
Request:
GET {TenantURL}/entities/recleanse?type=default
Headers: Authorization: Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512
[
{
"type": "configuration/entityTypes/Location",
"attributes": {
"AddressPaste": [
{
"type": "configuration/entityTypes/Location/attributes/AddressPaste",
"value": "Plateau du Kirchberg B.P. 1601 L-2929 Luxembourg"
}
]
}
},
{
"type": "configuration/entityTypes/Location",
"attributes": {
"AddressPaste": [
{
"type": "configuration/entityTypes/Location/attributes/AddressPaste",
"value": "357 King St, Newtown NSW 2042, Australia"
}
]
}
}
]
Response:
[
{
"index": 0,
"object": {
"uri": "entities/00dMPr7",
"type": "configuration/entityTypes/Location",
"createdTime": 1361296220548,
"updatedTime": 1361296220548,
"attributes": {
"AddressPaste": [
{
"type": "configuration/entityTypes/Location/attributes/AddressPaste",
"value": "Plateau du Kirchberg B.P. 1601 L-2929 Luxembourg",
"uri": "entities/00dMPr7/attributes/AddressPaste/vp"
}
],
"Street": [
{
"type": "configuration/entityTypes/Location/attributes/Street",
"value": "Plateau Du Kirchberg",
"uri": "entities/00dMPr7/attributes/Street/18D"
}
],
"ZipPostalCode": [
{
"type": "configuration/entityTypes/Location/attributes/ZipPostalCode",
"value": "2929",
"uri": "entities/00dMPr7/attributes/ZipPostalCode/1Oj"
}
],
"Country": [
{
"type": "configuration/entityTypes/Location/attributes/Country",
"value": "Luxembourg",
"uri": "entities/00dMPr7/attributes/Country/1GT"
}
]
},
"label": "Plateau Du Kirchberg "
},
"successful": true
},
{
"index": 1,
"object": {
"uri": "entities/00dMU7N",
"type": "configuration/entityTypes/Location",
"createdTime": 1361296220548,
"updatedTime": 1361296220548,
"attributes": {
"AddressPaste": [
{
"type": "configuration/entityTypes/Location/attributes/AddressPaste",
"value": "357 King St, Newtown NSW 2042, Australia",
"uri": "entities/00dMU7N/attributes/AddressPaste/zx"
}
],
"Street": [
{
"type": "configuration/entityTypes/Location/attributes/Street",
"value": "King St",
"uri": "entities/00dMU7N/attributes/Street/1nV"
}
],
"City": [
{
"type": "configuration/entityTypes/Location/attributes/City",
"value": "Newtown",
"uri": "entities/00dMU7N/attributes/City/1fF"
}
],
"StateProvince": [
{
"type": "configuration/entityTypes/Location/attributes/StateProvince",
"value": "NSW",
"uri": "entities/00dMU7N/attributes/StateProvince/1Wz"
}
],
"ZipPostalCode": [
{
"type": "configuration/entityTypes/Location/attributes/ZipPostalCode",
"value": "2042",
"uri": "entities/00dMU7N/attributes/ZipPostalCode/241"
}
],
"Country": [
{
"type": "configuration/entityTypes/Location/attributes/Country",
"value": "Australia",
"uri": "entities/00dMU7N/attributes/Country/1vl"
}
]
},
"label": "King St Newtown "
},
"successful": true
}
]