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 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.
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.
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.
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.
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."
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.
Új fájl hozzáadása a Crowdin projekthez.
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 a Crowdin projektből. Az összes fordítás elvész, anélkül, hogy visszaállíthassa őket.
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.
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.
Részletes fordítási előrehaladás a megadott nyelvhez.
Crowdin projekt részleteinek lekérdezése.
A Szerkesztőben jelentett problémák listájának lekérdezése.
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.
ZIP archívum építése a legújabb fordításokkal.
A fordítások exportálási állapotának lekérdezé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.
Crowdin projektfájlok előfordítása.
Projektlista lekérdezése.
Crowdin projekt létrehozása.
Crowdin projekt szerkesztése.
Crowdin projekt törlése az összes fordítással.
Könyvtár hozzáadása a Crowdin projekthez.
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).
Crowdin projektkönyvtár törlése. Minden beágyazott fájl és könyvtár törlésre kerül.
Crowdin projekt szójegyzékek letöltése TBX, CSV vagy XLSX fájlként.
Töltse fel a szójegyzékeit a Crowdin projektbe TBX, CSV vagy XLS/XLSX fájlformátumban.
Crowdin projekt Fordítási memóriájának letöltése TMX, CSV vagy XLSX fájlként.
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 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átszathonosítási fájlokat generál az egész projekt számára.
ZIP fájl letöltése látszat fordításokkal.
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.
A korábban generált Költségbecslési jelentés letöltése.
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.
A korábban generált Fordítási költségek jelentés letöltése.
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.
A korábban generált Legaktívabb tagok jelentés letöltése.
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.