API integráció beállítása
Vedd figyelembe, hogy az API 2.0 a preferált verzió. A régi API teljesen funkcionális marad 2021 végéig.
Crowdin RESTful API-t nyújt XML-lel vagy JSON-nal HTTP-n keresztül a GET vagy POST módszerek használatával. Az alábbiakban felsoroljuk az összes rendelkezésre álló API eljárást, amely lehetővé teszi a Crowdinban a projektek létrehozását, a fájlok felvételét és frissítését, fordítások letöltését, vagy a honosítás beépítését a fejlesztési folyamatába.
API kulcs beszerzése és használata
A Fiók API kulcsának megkereséséhez be kell jelentkeznie a Crowdin fiókjába. Nyissa meg a Fiók beállítások oldalt, majd váltson az API oldalra.
Kérjük, vegye figyelembe, hogy szinte az összes API hívás megkívánja a projekt azonosítóját (ID). A projektazonosítót a Projekt beállítások > API és Webhookok lapon találhatja meg.
Kérelmek benyújtása
Minden elvégzett API kérelemhez meg kell adnia a Fiók API kulcsát és a felhasználónevét, mint a hitelesítés fő URI paramétereit. Tartsa a Fiók API kulcsát titokban! Úgy kell védeni, ahogy a normál fiók jelszavát.
Íme egy példa az API kérés URI formájára.
GET https://api.crowdin.com/api/project/{project-identifier}/download/all.zip?login={username}&account-key={account-key}
A tipikus API URL hívás így néz ki: https://api.crowdin.com/api/project/. Az első helyőrző (zárójelben szereplő kulcsszó) a projekt azonosítóját tartalmazza. A Fiók API kulcsa és a felhasználónév URI paraméterekként van meghatározva.
Díjkorlátok
Az egyidejű API hívások száma fiókonként 20 kérelem. A túllépés esetén 429 hibakód jelenik meg a következő üzenettel: “Elérte az ehhez a végponthoz tartozó egyidejű kérelmek maximális számát. Kérjük, próbálja meg rövidesen újra."
Postman használata
A Postman egy olyan eszköz, amely lehetővé teszi, hogy egyszerűen dolgozhasson a Crowdin API-val.
Az összes elérhető Crowdin API módszer gyűjteményként elmentésre került itt: Postman. Kattintson a Fusson a Postman-ben elemre a gyűjtemény közvetlen importálásához és megnyitásához a Postman alkalmazásban.
Módszerek
Fájl hozzáadása
Új fájl hozzáadása a Crowdin projekthez.
Fájl frissítése
Töltse fel a forrásfájlok legújabb verzióját (azokat, amelyeket honosítani kell) a Crowdin projektjébe.
Fájl törlése
Fájl törlése a Crowdin projektből. Az összes fordítás elvész, anélkül, hogy visszaállíthassa őket.
Fordítás feltöltése
Meglévő fordítások feltöltése a Crowdin projektbe. A módszer nem működik a Kiegészítő eszközök honosításánál.
Fordítás állapota
Kövesse nyomon az egyes célnyelvek általános fordítását és lektorálását. Az alapértelmezett válaszformátum az XML.
Nyelv állapota
Részletes fordítási előrehaladás a megadott nyelvhez.
Projekt részletei
Crowdin projekt részleteinek lekérdezése.
Jelentett problémák
A Szerkesztőben jelentett problémák listájának lekérdezése.
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.
Fordítások exportálása
ZIP archívum építése a legújabb fordításokkal.
Fordítás exportálásának állapota
A fordítások exportálási állapotának lekérdezése.
Fordítások letöltése
Egy ZIP fájl letöltése fordításokkal. Kiválaszthatja a szükséges fordítás nyelvét, vagy egyszerre mindegyiket letöltheti.
Előfordítás
Crowdin projektfájlok előfordítása.
Fiók projektjei
Projektlista lekérdezése.
Projekt létrehozása
Crowdin projekt létrehozása.
Projekt szerkesztése
Crowdin projekt szerkesztése.
Projekt törlése
Crowdin projekt törlése az összes fordítással.
Könyvtár hozzáadása
Könyvtár hozzáadása a Crowdin projekthez.
Könyvtár módosítása
A könyvtár átnevezése, vagy az attribútumok módosítása. A könyvtár átnevezésével az elérési út nem módosítható (ez azt jelenti, hogy a new_name paraméter nem tartalmazhat útvonalat, csak nevet).
Könyvtár törlése
Crowdin projektkönyvtár törlése. Minden beágyazott fájl és könyvtár törlésre kerül.
Szójegyzék letöltése
Crowdin projekt szójegyzékek letöltése TBX, CSV vagy XLSX fájlként.
Szójegyzék feltöltése
Töltse fel a szójegyzékeit a Crowdin projektbe TBX, CSV vagy XLS/XLSX fájlformátumban.
FM letöltése
Crowdin projekt Fordítási memóriájának letöltése TMX, CSV vagy XLSX fájlként.
FM feltöltése
Töltse fel a Fordítási memóriáját a Crowdin projektbe TMX, CSV vagy XLS/XLSX fájlformátumban.
Támogatott nyelvek
Támogatott nyelvek listájának beszerzése a Crowdin kódokkal, amelyek a területi névre és a szabványos kódokra vannak leképezve.
Látszat export
Látszathonosítási fájlokat generál az egész projekt számára.
Látszat letöltés
ZIP fájl letöltése látszat fordításokkal.
Költségbecslési jelentés exportálása
A költségbecslési jelentés generálása annak érdekében, hogy betekintést nyerhessen a költségvetés megtervezéséhez. Ez a jelentés lehetővé teszi a projektben jelenleg le nem fordított karakterláncok hozzávetőleges fordítási költségének kiszámítását.
Költségbecslési jelentés letöltése
A korábban generált Költségbecslési jelentés letöltése.
Fordítási költségek jelentésének exportálása
Készítsen fordítási költségjelentéseket, mellyel kiszámíthatja a fordítóknak és lektoroknak fizetendő valódi fordítási költségeket.
Fordítási költségek jelentésének letöltése
A korábban generált Fordítási költségek jelentés letöltése.
Legaktívabb felhasználók jelentés exportálása
Legaktívabb tagok jelentés létrehoz egy listát a legjobb tagokról, hogy lássa, ki járult hozzá leginkább a projektje fordításához a megadott időtartományban.
Legaktívabb felhasználók jelentés letöltése
A korábban generált Legaktívabb tagok jelentés letöltése.
Crowdin API Java SDK
A Crowdin API Java SDK segíti a munkát a Java projektben szereplő összes Crowdin API módszerrel, mint például a fájlok hozzáadása és frissítése, a fordítások letöltése vagy a honosítás integrálása a fejlesztési folyamatba.