Fájl exportálása

Please consider that API 2.0 is now the preferred version to be used. The old API will remain fully functional until the end of 2021.

Crowdin API v2
Ez a módszer egyetlen lefordított fájlt exportál a Crowdinból. Ezenkívül XLIFF fájlok exportálására alkalmazható a kapcsolat nélküli honosításhoz.

Kérelem

Note: Use the combination of project identifier, username, and account key to pass to this endpoint.

GET https://api.crowdin.com/api/project/{project-identifier}/export-file?login={username}&account-key={account-key}
Megjegyzés: Crowdinból való fájlok exportálása során Etag azonosítót fog válaszként kapni a fejlécben. Tárolja el ezt az azonosítót, hogy a fájlok következő exportálásakor újra használhassa. Adja hozzá az Etag azonosítót a If-None-Match kérelem fejlécéhez, hogy lássa történt e bármi módosítás a fájlon. Abban az esetben, ha a fájl módosult, letöltésre kerül. Ha nem, akkor a 304 (nem módosult) állapotkódot kapja.

Paraméterek

Név Érték Leírás
file szükséges string Ez a paraméter megadja a projektből exportálandó fájl elérési útját.
language szükséges string Crowdin nyelvkódok.
branch opcionális string Kapcsolódó verzió-ág neve (Verziók kezelése).
format opcionális string xliff megadása a fájl XLIFF fájlformátumba exportálásához.
export_translated_only opcionális bool Akkor használja ezt a paramétert, ha csak a lefordított karakterláncokat szeretné látni az exportált fájlban. Nem javasoljuk ezt a beállítást, ha szöveges (*.html, *.txt, *.docx, stb.) dokumentumok vannak a projektben, mivel károsíthatja az eredményül kapott fájlokat. Elfogadható értékek: 1 vagy 0.
export_translated_files_only opcionális bool Akkor használja ezt a paramétert, ha csak a lefordított fájlokat szeretné exportálni. Elfogadható értékek: 1 vagy 0.
export_approved_only opcionális bool Ha az értéke 1-re van állítva, csak a jóváhagyott fordítások lesznek exportálva az eredményül kapott fájlban. Elfogadható értékek: 1 vagy 0.
Változók
project-identifier string Projekt azonosítója.
login string A felhasználóneve a Crowdinban.
account-key string A fiókja API kulcsa.

Példák

#Download file in the same file format as source
wget -O de.xml "https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.xml&language=de&login={username}&account-key={account-key}"

#Download file for offline translation in XLIFF file format
wget -O de.xliff "https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.html&format=xliff&language=de&login={username}&account-key={account-key}"
<?php
ini_set('default_socket_timeout', 5); // socket timeout, just in case

$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.html&format=xliff&language=de&login={username}&account-key={account-key}';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $request_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);

echo $result;

Hasznos volt ez a cikk?