Reference 360 > Reference 360 REST API > external localization
  

external localization

Use this resource to export a list of languages as code values from the Localization Languages code list, and import them into it. This list of languages represents the languages your organization supports for localization.
The predefined Localization Languages code list identifies each language by a BCP 47 language code and specifies the default language for your organization.
You can export the list of language code values fom the Localization Languages code list in a development organization and then import it into the Localization Languages code list in a production organization. You can also view the details of code values that were skipped in the import language code values report.
Preview Notice:
Effective in the October 2026 release, the ability to manage multilingual assets is available for preview.
Preview functionality is supported for evaluation purposes but is unwarranted and is not supported in production environments or any environment that you plan to push to production. Informatica intends to include the preview functionality in an upcoming release for production use, but might choose not to in accordance with changing market or technical circumstances. For more information, contact Informatica Global Customer Support.

Export localization languages

Exports a list of languages as code values from the Localization Languages code list.

GET request

To export the localization language code values, submit a GET request with the following URI:
/rdm-service/external/v1/localization/export

GET response

The response contains the details of the localization language code values.
The following table describes the attributes in the response body:
Field
Type
Description
defaultLanguage
String
Locale code of the default language for the organization, such as de-DE.
If an attribute value isn't available in a preferred language, then Reference 360 uses the default language to display the attributes and their values.
content
Array
List of languages exported from the Localization Languages code list.
Each language includes a language code and multilingual attributes for a code value.
codeValueFields
Object
Contains the attributes of a code value, its identifying code and the multilingual values of each attribute.
_localizedContent
Array
List of localized versions of the attributes of the code value.
_id
String
Locale code that identifies a language, such as pt-BR.
Name
String
Localized display name of the language.
_language
Object
Contains the details of the language code value.
Code
String
Locale code of the language code value, such as de-DE.
targetLanguages
Array
List of locale codes of the additional languages in which the organization stores multilingual content, such as en-US, de-DE, and pt-BR.

GET example

To get the details of the localization language code values to be exported, you might use the following request:
GET https://use4-mdm.dm-us.informaticacloud.com/rdm-service/external/v1/localization/export HTTP/1.1
IDS-SESSION-ID: XXXXXXXXXXXXXXXXXXXXXX
The following sample response shows the details of the localization language code values exported:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
IDS-SESSION-ID: XXXXXXXXXXXXXXXXXXXXXX

{
"defaultLanguage": "de-DE",
"content": [
{
"codeValueFields": {
"_localizedContent": [
{
"_id": "de-DE",
"Name": "Englisch US",
"_language": {
"Code": "de-DE"
}
},
{
"_id": "pt-BR",
"Name": "Inglês dos EUA",
"_language": {
"Code": "pt-BR"
}
},
{
"_id": "en-US",
"Name": "English United States",
"_language": {
"Code": "en-US"
}
}
],
"Code": "en-US"
}
},
{
"codeValueFields": {
"_localizedContent": [
{
"_id": "de-DE",
"Name": "Deutsch",
"_language": {
"Code": "de-DE"
}
},
{
"_id": "pt-BR",
"Name": "Alemã",
"_language": {
"Code": "pt-BR"
}
},
{
"_id": "en-US",
"Name": "German",
"_language": {
"Code": "en-US"
}
}
],
"Code": "de-DE"
}
},
{
"codeValueFields": {
"_localizedContent": [
{
"_id": "de-DE",
"Name": "Portugiesisch",
"_language": {
"Code": "de-DE"
}
},
{
"_id": "pt-BR",
"Name": "Português",
"_language": {
"Code": "pt-BR"
}
},
{
"_id": "en-US",
"Name": "Portuguese",
"_language": {
"Code": "en-US"
}
}
],
"Code": "pt-BR"
}
}
],
"targetLanguages": [
"en-US",
"de-DE",
"pt-BR"
]
}

Import localization languages

Imports language code values into the Localization Languages code list.

POST request

To import localization language code values into the Localization Languages code list, submit a POST request with the following URI:
/rdm-service/external/v1/localization/import
The following table describes the parameter in the request body:
Field
Type
Description
defaultLanguage
String
Locale code of the default language for the organization, such as de-DE.
If an attribute value isn't available in a preferred language, then Reference 360 uses the default language to display the attributes and their values.
content
Array
List of languages to import into the Localization Languages code list.
Each language includes a language code and multilingual attributes for a code value.
codeValueFields
Object
Contains the attributes of a code value, its identifying code and the multilingual values of each attribute.
_localizedContent
Array
List of localized versions of the attributes of the code value.
_id
String
Locale code that identifies a language, such as pt-BR.
Name
String
Localized display name of the language.
_language
Object
Contains the details of the language code value.
Code
String
Locale code of the language code value, such as de-DE.
targetLanguages
Array
List of locale codes of the additional languages in which the organization stores multilingual content, such as en-US, de-DE, and pt-BR.

POST response

The response contains the details of the multilingual code values that were imported.
The following table describes the attributes in the response body:
Field
Type
Description
createdCodeValueIds
Array
IDs of the code value for which multilingual values was created.
updatedCodeValueIds
Array
IDs of the code value for which existing multilingual values was updated.
excludedAndFailedCodeValueIds
Object
IDs of code value that were excluded or failed to import
codeValueId
Array
List of errors that caused the code value to be excluded or to fail.
errorCode
String
Code to identify the error.
errorSummary
String
A short summary that explains why the code value was excluded or failed.
errorParameter
String
Parameter the provides details of an error.
fieldname
String
Display attribute value for the code value that was excluded or failed.

POST example

To import code values, you might use the following request:
POST https://use4-mdm.dm-us.informaticacloud.com/rdm-service/external/v1/localization/import HTTP/1.1
Content-Type: application/json;charset=UTF-8
IDS-SESSION-ID: XXXXXXXXXXXXXXXXXXXXXX

{
"defaultLanguage": "de-DE",
"content": [
{
"codeValueFields": {
"_localizedContent": [
{
"_id": "de-DE",
"Name": "Englisch US",
"_language": {
"Code": "de-DE"
}
},
{
"_id": "pt-BR",
"Name": "Inglês dos EUA",
"_language": {
"Code": "pt-BR"
}
},
{
"_id": "en-US",
"Name": "English United States",
"_language": {
"Code": "en-US"
}
}
],
"Code": "en-US"
}
},
{
"codeValueFields": {
"_localizedContent": [
{
"_id": "de-DE",
"Name": "Deutsch",
"_language": {
"Code": "de-DE"
}
},
{
"_id": "pt-BR",
"Name": "Alemã",
"_language": {
"Code": "pt-BR"
}
},
{
"_id": "en-US",
"Name": "German",
"_language": {
"Code": "en-US"
}
}
],
"Code": "de-DE"
}
},
{
"codeValueFields": {
"_localizedContent": [
{
"_id": "de-DE",
"Name": "Portugiesisch",
"_language": {
"Code": "de-DE"
}
},
{
"_id": "pt-BR",
"Name": "Português",
"_language": {
"Code": "pt-BR"
}
},
{
"_id": "en-US",
"Name": "Portuguese",
"_language": {
"Code": "en-US"
}
}
],
"Code": "pt-BR"
}
}
],
"targetLanguages": [
"en-US",
"de-DE",
"pt-BR"
]
}
The following sample response shows the details of multilingual code values that were imported:
{
"createdCodeValueIds": [
"68417a0b8fb05a12ea3448ed",
"68417a0b8fb05a12ea3448ee",
"68417a0b8fb05a12ea3448ef"
],
"updatedCodeValueIds": [
"68417a0b8fb05a12ea34559d",
"68417a0b8fb05a12ea3559ee",
"68417a0b8fb05a12ea35598ef"
],
"excludedAndFailedCodeValueIds": {
"68417a0c8fb05a12ea344900": [
{
"errorCode": "RDM.0010001",
"errorSummary": "Mandatory field is missing or empty",
"errorParameter": {
"fieldname": "Name"
}
}
],
"68471b52e47799288730f733": [
{
"errorCode": "RDM.0010001",
"errorSummary": "Mandatory field is missing or empty",
"errorParameter": {
"fieldname": "Name"
}
}
]
}
}