Sada API volání je k dispozici, která umožňuje:
-
Integraci Phrase a jakéhokoli softwaru třetích stran (nástroje pro správu překladů, CMS atd.).
-
Vývoj pracovního stolu překladatele. CAT editor je postaven na veřejných API.
-
Vytvoření zcela nového nástroje nebo služby pomocí Phrase jako backendu.
Základní pracovní postup
Postupy a pracovní postup musí být pochopeny před použitím API. Doporučuje se být obeznámen s postupem v Phrase před implementací souvisejícího API.
Základní pracovní postup je:
-
Vytvořte TM, TB a volitelně přidejte strojový překladový nástroj.
-
Vytvořte projekt s připojeným TM/TB/strojovým překladovým nástrojem (pokud je to potřeba).
-
Uložte projekt jako šablonu projektu a znovu ji použijte k vytvoření nového překladového projektu.
-
Nahrajte svůj soubor k překladu do projektu (vytvořte job).
-
Poté můžete analyzovat, předpřeložit nebo přiřadit zakázku překladateli.
Asynchronní API
Asynchronní API by měla být vždy preferována před jejich synchronními protějšky. Pokud voláte synchronní API, může dojít k obdržení odpovědí s vypršením časového limitu při zpracování velkých dávek souborů nebo dokonce jednoho velkého souboru. Synchronní API by měla být používána pouze pro malé soubory a malé měřítko integrace.
Polling
Po zavolání asynchronního API je přijata okamžitá odpověď včetně identifikátoru požadavku. Použijte tento identifikátor k ověření stavu žádosti voláním getAsyncRequest a kontrolou pole asyncResponse. Tento polling přístup může vést k několika getAsyncRequest voláním před obdržením asyncResponse, které není null.
Zpětná volání
Jako odpověď na nevýhody polling přístupu k asynchronním žádostem je podpora zpětných volání ve všech asynchronních API podporována. Při volání asynchronní žádosti specifikujte URL (v parametru callbackUrl), která je požadována po dokončení práce zahájené asynchronní žádostí.
Zpětná volání jsou požadována prostřednictvím HTTP POST volání a data jsou předávána v těle zakódovaná jako JSON. JSON objekt vždy obsahuje:
-
Informace o asynchronní žádosti (stejné jako při volání getAsyncRequest).
-
Podrobné informace o výsledku akce, například úplná analýza nebo podrobnosti o zakázce.
{
"asyncRequest": {
...
}
"analyse": {
...
}
}
Pokud není URL zpětného volání přístupná, žádost se opakuje po 2, 4, 8, 16 a 30 minutách, dokud nedojde k 10 neúspěšným pokusům.
URL zpětného volání musí odpovědět s HTTP stavem 200 OK, aby byla považována za úspěšnou.