Зареєструйтеся як розробник і отримайте API-ключ
Надає RESTful API для перекладу документів із підтримкою автоматизованого управління завданнями перекладу, термінологічної узгодженості на основі глосарія та запитів щодо підтримуваних форматів, мов і моделей, що забезпечує легке створення безперебійних робочих процесів перекладу та управління обліковими записами користувачів.
Початок роботи
Щоб розпочати роботу, необхідно подати заявку на отримання статусу розробника.Подати заявку як розробник
Після схвалення ви можете створити кілька API-ключів та включити відповідний API-ключ у кожен API-запит за потребою.
Швидке підключення
Базовий 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
- Відсутні обов'язкові параметри, неправильні формати параметрів або значення enum, відсутнє завантаження файлу, помилка збереження завантаження або помилка обробки завдання.
- 401 Unauthorized
- Відсутній ключ API або недійсний ключ API.
- 402 Payment Required
- Недостатньо кредитів на балансі для попереднього перегляду, повного перекладу або перекладу тексту.
- 404 Not Found
- Завдання або глосарій не існує, був видалений, не належить до поточного облікового запису API або не був створений через API.
- 409 Conflict
- Поточний статус завдання не дозволяє виконати запитувану операцію.
- 500 Internal Server Error
- Неочікуване виключення сервера. Помилка відповіді фіксована як "Внутрішня помилка сервера.".
Рекомендований процес підключення
1. Створення завдання
Завантажує файл і створює завдання перекладу, повертає taskId.
2. Запит прогресу
Опитувати стан завдання до досягнення Completed, Terminated або Cancelled.
3. Отримання результату
Завантажує файл перекладу або зчитує JSON оригіналу та перекладу.
4. Управління завданнями
Посервісна оплата повного перекладу тексту, перезапуску завдань, редагування тексту або видалення завдань.