Введение
Предоставляет RESTful 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. Управлять задачами
Оплата по мере использования полного перевода, перезапуск задачи, редактирование текста или удаление задачи.