Úvod

Poskytuje RESTful API pre preklad dokumentov, podporuje automatizované riadenie prekladateľských úloh, terminologickú konzistentnosť založenú na glosároch a dotazy na podporované formáty, jazyky a modely, čo umožňuje jednoduché vytváranie plynulých prekladateľských pracovných postupov a správu používateľských účtov.

Začíname

Pre začiatok sa musíte zaregistrovať ako vývojár.Prihlásiť sa ako vývojár

Po schválení môžete vytvoriť viacero API kľúčov a zahrnúť príslušný API kľúč do každej API požiadavky podľa potreby.

Získať váš API kľúč

Rýchle pripojenie

Base URL

https://dltranslator.com/api

Spôsob autentifikácie

Authorization: [yourSecretKey]

JSON požiadavka

Okrem rozhrania pre nahrávanie súborov používajú rozhrania štandardne POST JSON požiadavky, Content-Type je application/json.

Nahrávanie súboru

Vytvorenie úlohy prekladu dokumentu používa multipart/form-data, pole file prenáša súbor určený na preklad.

Univerzálna chybová odpoveď

Pri zlyhaní požiadavky rozhranie vráti JSON, pole error obsahuje fixnú anglickú chybovú správu. Odporúča sa prednostne rozvetvovať spracovanie chýb podľa HTTP status code, pole error používať na zobrazenie alebo záznam do logu.

{
  "error": "Invalid API key."
}

Pravidlá kódov chybových stavov

Všetky chybové odpovede v1 API zachovávajú rovnakú štruktúru, prosím spracujte ich podľa nasledujúcich pravidiel HTTP status code.

400 Bad Request: Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
401 Unauthorized: Missing API key or invalid API key.
402 Payment Required: Insufficient credits balance for preview, full translation, or text translation.
404 Not Found: The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
409 Conflict: The current task status does not allow the requested operation.
500 Internal Server Error: Unexpected server exception. The response error is fixed as "Internal server error.".

Odporúčaný postup pripojenia

1. Vytvorenie úlohy

Nahrať súbor a vytvoriť prekladovú úlohu, vracia taskId.

2. Kontrola priebehu

Dotazovať stav úlohy, kým nedosiahne Completed, Terminated alebo Cancelled.

3. Získanie výsledkov

Stiahnuť preložený súbor alebo načítať pôvodný a preložený JSON.

4. Správa úloh

Platba podľa použitia za preklad celého textu, reštartovanie úlohy, revíziu textu alebo odstránenie úlohy.

Zdroje

Komunita vývojárov

Ak máte akékoľvek otázky, môžete získať pomoc v komunite vývojárov.