Skip to main content
Version: 24.3

loc-2.v1

This endpoint provides localization and allows a client to retrieve the suggested localization of multiple strings. Often other Digital.ai Agility endpoints will return unlocalized strings such as suggested names or error messages. These unlocalized strings may be passed to loc-2.v1 which will attempt to translate the strings into locale specific strings returned as a JSON object with key-value pairs for each translation.

In a case where a locale specific string could not be found, a series of fallbacks exist. For example if French-Canadian (fr-ca) does not have a localization entry for the string "Story", the French locale (fr) will be searched, and then finally the English (en) locale will be searched. If no localization entry exists in any locale, the input string will be returned unchanged. To retrieve a localized string for a specific locale, set the "Accept-Language" HTTP Header in the request to a specific locale. For example to use French-Canadian set the header to "fr-ca".

URL Form<Server Base URI>/loc-2.v1?<json_string_array>
AuthenticationNone
HTTP Request VerbHTTP GET
Response Content Typeapplication/json

API

Request Parameters​

json_string_array

Examples​

Asset Types​

The following example will retrieve the localized names of the Scopeand Timebox asset types.

            <Server Base URI>/loc-2.v1?[Scope,Timebox]

The response is as follows.

            {
            Scope: "Project",
            Timebox: "Sprint"
        }

Scope is the internal VersionOne name for a project, sub-project, or release. Timebox is the internal VersionOne name for an Iteration or Sprint.

Attribute Definitions​

The following example will retrieve the display names for Story.Name and Story.Description.

            <Server Base URI>/loc-2.v1?[AttributeDefinition'Name'Story,AttributeDefinition'Description'Story]

The response is as follows.

            {
            AttributeDefinition'Name'Story: "Title",
            AttributeDefinition'Description'Story: "Description"
        }

The response contains the word "Title" which directly corresponds to the field label used in the Agility application.