Projektmenedzsereknek

Fordítóknak

Fejlesztőknek

API v1
Nyelvek
Notifications and Webhooks
IP Addresses and Domains

Vállalat

Költségbecslési jelentés exportálá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 API v2
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érelem

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

POST https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?login={username}&account-key={account-key}

Paraméterek

Név Érték Leírás
unit opcionális string Meghatározza a jelentés egységét. Elfogadható értékek: 'strings', 'words' (alapértelmezett), 'chars', 'chars_with_spaces'.
mode opcionális string A jelentés módját határozza meg. Elfogadható értékek: 'simple' (alapértelmezett), 'fuzzy'.
calculate_internal_fuzzy_matches opcionális bool Csak a kevert (fuzzy) módban áll rendelkezésre. Megszámolja az összes belső egyezést, hogy ellenőrizze, hogy hány karakterláncot lehet hozzáadni és használni a Fordítási memóriához, ha a karakterláncok egyenként kerülnek lefordításra, mint a felsorolásban. Ne feledje, hogy a számítások hozzávetőlegesek, mert a karakterláncok eltérő sorrendben is lefordíthatók. Elfogadható értékek: 1 vagy 0.
language szükséges string A nyelv, melyre a jelentés készüljön. Ehhez használja a Сrowdin nyelvkódokat.
date_from opcionális date Adott időpont után hozzáadott karakterláncok. A következő ISO 8601 dátumformátumot használja: YYYY-MM-DD±hh:mm
date_to opcionális date Adott időpontig hozzáadott karakterláncok. A következő ISO 8601 dátumformátumot használja: YYYY-MM-DD±hh:mm
regular_rates opcionális array A megadott kategóriák normál díját határozza meg.
         Az egyszerű jelentés lehetséges kategóriái a következők: 'default', 'tm', és 'approval'.
         A kevert jelentés lehetséges fuzzy kategóriái a következők: 'approval', 'translation', 'perfect', 'matched', és három egyéni tartomány 60% és 100% között (például: 99-90).
individual_rates opcionális array Megadja az egyéni árakat a meghatározott nyelvekhez a megadott kategóriákban. Minden elemnek tartalmaznia kell a nyelv és az ár paramétereket. A lehetséges árkategóriák ugyanazok, mint a 'regular_rates' paraméter esetén.
currency opcionális string Meghatározza azt a pénznemet, amelyre a teljes jelentés készül. Elfogadható értékek: '$' (alapértelmezett), '€', '¥', '£', 'A$', 'C$', 'Fr', 'CN¥', 'kr', 'NZ$', 'MX$', 'S$', 'HK$', 'kr', '₩', '₺', '₽', '₹', 'R$', 'R'.
format opcionális string Az exportálási fájlformátumot határozza meg. Az elfogadható értékek: 'csv' és 'xlsx' (alapértelmezett).
json opcionális string Lehet, hogy nem tartalmaz értéket. Meghatározza, hogy a válasz JSON formátumban kell legyen.
jsonp opcionális string Visszahívási függvény neve. Meghatározza, hogy a válasz JSONP formátumban kell legyen.
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.

Válasz

Ha a módszer sikeres, akkor XML struktúrával válaszol, ahogy az az alábbiakban látható. 
<?xml version="1.0" encoding="UTF-8"?>
<success>
  <hash>x1ff24323a2f6058382b31fbc237bcd74</hash>
</success>
Sikertelen válasz példa: 
<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>3</code>
  <message>API key is not valid</message>
</error>

Példák

  curl \
    -F "unit=chars" \
    -F "mode=simple" \
    -F "format=csv" \
    -F "language=uk" \
    -F "date_from=2017-01-01" \
    -F "date_to=2017-01-03" \
    -F "regular_rates[default]=1.05" \
    -F "regular_rates[tm]=1.00" \
    -F "regular_rates[approval]=2.00" \
    https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?login={username}&account-key={account-key}
  
  curl \
    -F "unit=words" \
    -F "mode=fuzzy" \
    -F "format=xlsx" \
    -F "language=uk" \
    -F "date_from=2017-06-05+0200" \
    -F "regular_rates[translation]=2.05" \
    -F "regular_rates[perfect]=1.00" \
    -F "regular_rates[matched]=1.00" \
    -F "regular_rates[99-95]=1.03" \
    -F "regular_rates[94-90]=1.05" \
    -F "regular_rates[89-80]=1.20" \
    -F "regular_rates[approval]=3.00" \
    https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?login={username}&account-key={account-key}
  
<?php
$request_url = 'https://api.crowdin.com/api/project/{project-identifier}/reports/costs-estimation/export?mode=words&login={username}&account-key={account-key}&language=uk';

$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?