Is this really the version you are looking for? Kentico Xperience 8.2 Documentation is no longer updated. Use the switcher in the header to choose your product version.
Kentico EMS required
Features described on this page require the Kentico EMS license.
Kentico provides a way to retrieve and submit translation data through REST (opens in a new tab). This service allows you to manage page translations using HTTP request methods. You can utilize the REST service in the code of your custom translation services to transfer data in and out of the system.
Use the following root URL to access the REST translation service:
~/rest/translate/
Replace the ~ character with the domain name and virtual directory of your website, for example: http://localhost/KenticoCMS/rest/translate/
To set up your website for handling translation operations via the REST service:
To retrieve page translation data, send an HTTP GET request to a URL in one of the following formats:
Set the target language of the translation by adding the corresponding culture code into the targetlanguage URL parameter. The system automatically fills in the source language based on the language version of the specified page.
The request returns a response containing XLIFF data that you can use as the translation source. The REST service only supports retrieval of a single object per request.
Examples:
~/rest/translate/content/site/CorporateSite/en-us/document/Services?targetlanguage=fr-fr
~/rest/translate/content/currentsite/fr-fr/document/Company/Careers?targetlanguage=cs-cz
You can also use the following boolean parameters in the URL:
See also: Configuring content for translation
To import a translation into the system, send a POST request to the root URL of the REST translation service:
~/rest/translate/
Add the XLIFF content of the completed translation into the body of the request.
The root URL of the service is the only access point used for submitting translations. The system automatically identifies the target page based on the XLIFF data. When the system processes the request, it creates the appropriate language version of the page (if necessary) and inserts the translation data.
POST http://localhost/KenticoCMS/rest/translate/
User-Agent: REST client
Authorization: Basic <enter <username>:<password> encoded in Base64>
Host: localhost
Content-Type: text/xml
<xliff version="1.2">
<file original="cms.document;9" source-language="en-US" target-language="fr-FR" datatype="htmlbody">
<body>
<trans-unit id="menuitemname">
<source><![CDATA[Company]]></source>
<target><![CDATA[Entreprise]]></target>
</trans-unit>
<trans-unit id="pagename">
<source><![CDATA[Company]]></source>
<target><![CDATA[Entreprise]]></target>
</trans-unit>
<trans-unit id="editable;we">
<source><![CDATA[<p>Source text.</p>]]></source>
<target><![CDATA[<p>Translated text.</p>]]></target>
</trans-unit>
<trans-unit id="editable;wh">
<source><![CDATA[Company]]></source>
<target><![CDATA[Entreprise]]></target>
</trans-unit>
</body>
</file>
</xliff>