Get Relationship
This operation returns a relation by URI.
Request
GET {TenantURL}/{relation object URI}| Parameter | Required | Default Value | Details | |
|---|---|---|---|---|
| Headers | authorization | Yes | Provides information about the authentication access token in format "Bearer <accessToken>" (see details in Authentication API ). | |
| Query | options | No |
| Passes a comma-separated list of options for the relationships the API should return:
|
| reverseTranscodeLookups | No | Provides the destination system name for which the system needs to perform reverse transcoding of RDM attributes. For example, to reverse transcode the lookup values used in Reltio to the values in Salesforce, set this parameter to Salesforce:
Note: You can use this parameter for RDM attributes in Get entity API.
| ||
Reverse Transcoding
If an attribute is bound by RDM, the system transcodes the value to a canonical or a standard value of Reltio. In certain cases, when Reltio sends the values back to the source application, it needs to provide the raw value according to that system. This is called reverse transcoding.
For example, a relationship attribute value in RDM is Engineering for the Department attribute and its corresponding value is Eng in a source application. When the data comes to Reltio from the source application, the system transcodes Eng value to a canonical or a standard value, Engineering. When the same value is sent back to the source application, which is reverseTranscodeLookups in this API call, it is reverse transcoded to the original value of Eng.
Response
JSON Object representing object with URI.
Request
GET {TenantURL}/relations/r1
Headers: Authorization: Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512Response
GET {TenantURL}/relations/r1
Headers: Authorization: Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512
{
"URI":"relations/r1",
"type":"configuration/relationTypes/Employment",
"startObject":{
"URI":"relations/r1/startObject",
"objectURI":"entities/e1",
"type":"configuration/entityTypes/Individual",
"label":"John Smith",
"directionalLabel":"employee"
},
"endObject":{
"URI":"relations/r1/endObject",
"objectURI":"entities/e2",
"type":"configuration/entityTypes/Organization",
"label":"Super Company",
"directionalLabel":"employer"
},
"attributes":{
"URI": "relations/r1/attributes",
"Title":[
{
"URI": "relations/r1/attributes/Title/1",
"type": "configuration/relationTypes/Employment/attributes/Title",
"value":"CEO"
}
]
},
"crosswalks":[
{
"URI": "relations/r1/crosswalks/1",
"type":"configuration/sources/MDM",
"value":"Employemnt.1000",
"attributes": [
"relations/r1/attributes/Title/1"
]
}
]
}