curl --request POST \
--url https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rawFiles": [
{
"storageId": "e48eda63928c4155bez9fdbsaadc15f3",
"info": {
"name": "entry-123.json"
}
}
],
"sourceLocale": "en-US"
}
'import requests
url = "https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff"
payload = {
"rawFiles": [
{
"storageId": "e48eda63928c4155bez9fdbsaadc15f3",
"info": { "name": "entry-123.json" }
}
],
"sourceLocale": "en-US"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
rawFiles: [
{storageId: 'e48eda63928c4155bez9fdbsaadc15f3', info: {name: 'entry-123.json'}}
],
sourceLocale: 'en-US'
})
};
fetch('https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'rawFiles' => [
[
'storageId' => 'e48eda63928c4155bez9fdbsaadc15f3',
'info' => [
'name' => 'entry-123.json'
]
]
],
'sourceLocale' => 'en-US'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff"
payload := strings.NewReader("{\n \"rawFiles\": [\n {\n \"storageId\": \"e48eda63928c4155bez9fdbsaadc15f3\",\n \"info\": {\n \"name\": \"entry-123.json\"\n }\n }\n ],\n \"sourceLocale\": \"en-US\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rawFiles\": [\n {\n \"storageId\": \"e48eda63928c4155bez9fdbsaadc15f3\",\n \"info\": {\n \"name\": \"entry-123.json\"\n }\n }\n ],\n \"sourceLocale\": \"en-US\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rawFiles\": [\n {\n \"storageId\": \"e48eda63928c4155bez9fdbsaadc15f3\",\n \"info\": {\n \"name\": \"entry-123.json\"\n }\n }\n ],\n \"sourceLocale\": \"en-US\"\n}"
response = http.request(request)
puts response.read_body""""Convert raw content from Contentful to XLIFF synchronously
Convert raw Contentful content already in Phrase file storage to XLIFF 2.0, without
re-downloading from Contentful. Each entry in rawFiles references a stored file
(storageId) plus the metadata the connector needs to segment correctly.
Use this when you have a snapshot from download-raw-file and want to defer the
conversion step (e.g. to apply custom pre-processing first).
curl --request POST \
--url https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rawFiles": [
{
"storageId": "e48eda63928c4155bez9fdbsaadc15f3",
"info": {
"name": "entry-123.json"
}
}
],
"sourceLocale": "en-US"
}
'import requests
url = "https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff"
payload = {
"rawFiles": [
{
"storageId": "e48eda63928c4155bez9fdbsaadc15f3",
"info": { "name": "entry-123.json" }
}
],
"sourceLocale": "en-US"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
rawFiles: [
{storageId: 'e48eda63928c4155bez9fdbsaadc15f3', info: {name: 'entry-123.json'}}
],
sourceLocale: 'en-US'
})
};
fetch('https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'rawFiles' => [
[
'storageId' => 'e48eda63928c4155bez9fdbsaadc15f3',
'info' => [
'name' => 'entry-123.json'
]
]
],
'sourceLocale' => 'en-US'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff"
payload := strings.NewReader("{\n \"rawFiles\": [\n {\n \"storageId\": \"e48eda63928c4155bez9fdbsaadc15f3\",\n \"info\": {\n \"name\": \"entry-123.json\"\n }\n }\n ],\n \"sourceLocale\": \"en-US\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rawFiles\": [\n {\n \"storageId\": \"e48eda63928c4155bez9fdbsaadc15f3\",\n \"info\": {\n \"name\": \"entry-123.json\"\n }\n }\n ],\n \"sourceLocale\": \"en-US\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu.phrase.com/connectors/contentful2/v1/sync/convert-to-xliff")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rawFiles\": [\n {\n \"storageId\": \"e48eda63928c4155bez9fdbsaadc15f3\",\n \"info\": {\n \"name\": \"entry-123.json\"\n }\n }\n ],\n \"sourceLocale\": \"en-US\"\n}"
response = http.request(request)
puts response.read_body""""Authorizations
IDM-issued JWT. Obtain via the IDM authentication flow and pass as: Bearer
Headers
A logging ID of the request. It is propagated through Phrase systems, making it easier to connect logs from various services. If no ActionId is sent with a request, one will be generated by Bifrost and returned with the response.
Specify if the response should contain the processed object itself in an application/octet-stream body, or a application/json body with an ID that can be then used to retrieve the object using a /load-content endpoint. Note that for larger files (> 1 MB), it is advised to use the ID option which is also default.
ID, OBJECT Body
Request body for converting already-stored raw Contentful content into XLIFF 2.0 without re-downloading from Contentful.
List of stored raw files (each carrying its storageId and original metadata) to convert.
Show child attributes
Show child attributes
Source locale of the content (Contentful locale code).
1"en-US"
Contentful-specific behavior knobs (tag filter, reference inlining, asset handling, …).
Response
OK — XLIFF binary stream (returned when X-ResponseType=OBJECT).
The response is of type file.
Was this page helpful?