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