Úvod
Poskytuje RESTful API pro překlad dokumentů, podporuje automatizované řízení překladových úloh, terminologickou konzistenci založenou na glosářích a dotazy na podporované formáty, jazyky a modely, což usnadňuje vytváření bezproblémových překladových postupů a správu uživatelských účtů.
Začínáme
Pro začátek se musíte přihlásit jako vývojář.Přihlásit se jako vývojář
Po schválení můžete vytvořit více API klíčů a zahrnout příslušný API klíč do každého API požadavku podle potřeby.
Rychlé připojení
Base URL
https://dltranslator.com/api
Způsob ověření
Authorization: [yourSecretKey]
JSON požadavek
Kromě rozhraní pro nahrávání souborů používají API ve výchozím nastavení POST JSON požadavky, Content-Type je application/json.
Nahrání souboru
Vytvoření úkolu pro překlad dokumentu používá multipart/form-data, v poli file se předává soubor k překladu.
Obecná chybová odpověď
Při selhání požadavku rozhraní vrací JSON, pole error obsahuje pevnou anglickou chybovou zprávu. Doporučuje se přednostně zpracovávat chyby podle HTTP status code, pole error používat pro zobrazení nebo záznam do logu.
{
"error": "Invalid API key."
}Pravidla pro chybové stavové kódy
Všechny chybové odpovědi v1 API mají stejnou strukturu, zpracujte je prosím podle následujících pravidel 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.".
Doporučený proces připojení
1. Vytvořit úkol
Nahrajte soubor a vytvořte překladatelský úkol, vrací taskId.
2. Zkontrolovat průběh
Průběžně zjišťujte stav úkolu, dokud nebude Completed, Terminated nebo Cancelled.
3. Získat výsledek
Stáhněte přeložený soubor nebo načtěte JSON s originálem a překladem.
4. Spravovat úkoly
Platba dle spotřeby za překlad celého textu, restartování úlohy, revizi textu nebo smazání úlohy.