Fájl exportálása

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

Figyelem: Vagy a projekt kulcs vagy a felhasználónév és a fiók kulcs kombinációja adható át ehhez a végponthoz. Projekt azonosítója mindkét esetben átadásra kerül.

GET https://api.crowdin.com/api/project/{project-identifier}/export-file?key={project-key}
GET https://api.crowdin.com/api/project/{project-identifier}/export-file?login={username}&account-key={account-key}
Figyelem: 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
key szükséges string Projekt API kulcs
project-identifier szükséges string A projekt azonosítóját kell tartalmaznia.
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 Meghatározza, hogy csak a lefordított karakterláncokat kell e exportálni a végleges fájlba. 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_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. Az elfogadható értékek: 1 vagy 0.

Példák

#Fájl letöltése a forrással megegyező formátumban
wget -O de.xml "https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.xml&language=de&key={project-key}"

#Fájl letöltése XLIFF fájlformátumban kapcsolat nélküli fordításhoz
wget -O de.xliff "https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.html&format=xliff&language=de&key={project-key}"
<?php
ini_set('auto_detect_line_endings', 1);
ini_set('default_socket_timeout', 5); // socket timeout, just in case

file_put_contents('it.xliff', file_get_contents('https://api.crowdin.com/api/project/{project-identifier}/export-file?file=en.html&format=xliff&language=de&key={project-key}'));

Hasznos volt ez a cikk?