Въведение

Предоставя RESTful API за превод на документи, поддържащи автоматизирано управление на преводни задачи, терминологична консистентност чрез речници и заявки за поддържани формати, езици и модели, което улеснява създаването на безпроблемни работни процеси за превод и управление на потребителски акаунти.

Първи стъпки

За да започнете, трябва да подадете заявление, за да станете разработчик.Кандидатствай като разработчик

След одобрение можете да създадете множество API ключове и да включите подходящия API ключ във всяка API заявка според изискванията.

Получете вашия API ключ

Бърз достъп

Base URL

https://otranslator.com/api

Начин на удостоверяване

Authorization: [yourSecretKey]

JSON заявка

Освен интерфейса за качване на файлове, интерфейсите по подразбиране използват POST JSON заявки, а Content-Type е application/json.

Качване на файл

Създаването на задача за превод на документ използва multipart/form-data, полето file предава файла, който трябва да бъде преведен.

Общ отговор за грешка

При неуспешна заявка интерфейсът ще върне JSON, където полето error съдържа фиксирано съобщение за грешка на английски език. Препоръчва се грешките да се обработват приоритетно според HTTP status code, а полето error да се използва за показване или записване в логове.

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

Правила за кодове на грешки

Всички съобщения за грешка от v1 API запазват една и съща структура, моля обработвайте според следните правила за 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.".

Препоръчителен процес на интегриране

1. Създаване на задача

Качете файл и създайте задача за превод, връща се taskId.

2. Проверка на прогреса

Проверявайте статуса на задачата, докато стане Completed, Terminated или Cancelled.

3. Получаване на резултат

Изтеглете преведения файл или прочетете оригиналния и преведения JSON.

4. Управление на задачи

Плащане по заявка за пълен превод на текст, рестартиране на задачи, ревизиране на текст или изтриване на задачи.

Ресурси

Общност на разработчици

Ако имате въпроси, можете да получите помощ в общността на разработчиците.