Transcode API
API to transcode lookup values
Most of the time reference data is standardized before being imported or used by enterprise systems or applications. However, some data elements are represented differently in different applications. These differences can cause problems when different systems or applications interact. Reltio's Transcoding APIs can be used to convert the source system data to canonical (standardized) values before bringing in this data into Reltio. You can transcode simple and hierarchical lookups. In addition, reverse transcoding can be performed.
Transcode Simple Lookup
Request
POST https://{{rdm-service}}/transcode/rdm/value
Authorization: Bearer {{token}}
{
"type": "rdm/lookupTypes/City",
"value": "M",
"source": "ABCD"
}Response
{
"type": "rdm/lookupTypes/City",
"code": "rdm/City/M"
"value": "Moscow",
"source": "rdm/sources/ABCD"
"success": true
}Transcode Hierarchical Lookups
POST https://{{rdm-service}}/transcode/rdm
Authorization: Bearer {{token}}
[
{
"values": {
"rdm/lookupTypes/State": [
{
"value": "CA",
"source": "ABCD"
}
]
},
"dependentValues": [
{
"values": {
"rdm/lookupTypes/City": [
{
"value": "SF",
"source": "rdm/sources/ABCD"
}
]
}
}
]
}
]Response
[
{
"values": [
{
"type": "rdm/lookupTypes/State",
"value": "CA",
"source": "ABCD",
"error": "1001: Source system [ABCD] not found in tenant [rdm]",
"success": false
}
],
"dependentValues": [
{
"values": [
{
"type": "rdm/lookupTypes/City",
"value": "SF",
"source": "ABCD",
"error": "1001: Source system [ABCD] not found in tenant [rdm]",
"success": false
}
]
}
]
}
]Reverse Transcoding
Reverse transcoding is applied using Transcode
API, with &targetSource=AHA in request parameters.
Note: When
targetSource is not specified or contains a non-existing source system,
API request will return a canonical value.Request
POST {{rdm_uri}}/transcode/{{rdm_tenant}}/value?targetSource=AHA
HEADERS:
Accept-Language: es-mx
BODY:
{
"type": "rdm/lookupTypes/Country",
"value": "US",
"source": "rmd/sources/Reltio"
}Response
{
"type": "rdm/lookupTypes/Country",
"code": "080",
"value": "USA",
"source": "rdm/sources/Reltio",
"success": true
}