Registrujte se jako vývojář a získejte API klíč

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.

Získejte svůj API klíč

Rychlé připojení

Základní URL

https://otranslator.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: Chybějící povinné parametry, neplatné formáty parametrů nebo hodnoty výčtu, chybějící nahrání souboru, selhání uložení nahrání nebo selhání zpracování úlohy.
401 Unauthorized: Chybějící API klíč nebo neplatný API klíč.
402 Payment Required: Nedostatečný zůstatek kreditů pro náhled, plný překlad nebo překlad textu.
404 Not Found: Úkol nebo glosář neexistuje, byl smazán, nepatří k aktuálnímu API účtu nebo nebyl vytvořen prostřednictvím API.
409 Conflict: Aktuální stav úlohy neumožňuje požadovanou operaci.
500 Internal Server Error: Neočekávaná výjimka serveru. Chyba odpovědi je nastavena na "Interní chyba serveru.".

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.

Zdroje

Vývojářská komunita

Pokud máte jakékoli dotazy, můžete získat pomoc ve vývojářské komunitě.