WE-TRANSLATE / API V1

API для переводов

Создавайте заказы профессиональных лингвистических переводов из своей программы. Расчёт и оплата используют тарифы и баланс вашего аккаунта we-translate.biz.

Подключение

Войдите в кабинет и создайте ключ с нужными разрешениями. Ключ показывается один раз.
Храните ключ на своём сервере и передавайте его только по HTTPS в заголовке Authorization.
Начните с чтения профиля. Ключ «Только чтение» позволяет читать данные и рассчитывать цену. Для создания и оплаты заказа нужен ключ записи.

GET https://api.we-translate.biz/v1/user/view
Authorization: Bearer YOUR_API_KEY
Accept: application/json

Альтернативный адрес с теми же данными и ключами: https://we-translate.biz/api/v1

Создание заказа

На первом этапе доступны текстовые переводы: 19 языков и четыре типа услуг — general, business, literary, legal. Язык можно передать кодом en, ru, de и т. д. или идентификатором из справочника. Типы файлов, аудио и создание других клиентов в этой версии недоступны.

1. Создайте черновик и проверьте цену

Создание черновика не списывает средства и не отправляет заказ переводчику. Цена действует 10 минут. external_id — необязательный уникальный номер из вашей системы.

curl 'https://api.we-translate.biz/v1/order/create-as-draft' \
  -H "Authorization: Bearer $WT_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: draft-your-unique-reference-001' \
  --data '{"service":"general","from":"en","to":"ru",
    "source_text":"The translation text goes here.",
    "external_id":"your-order-001"}'

{"ok":true,"status":201,"order":{
  "id":"d_0123456789abcdef0123456789abcdef",
  "status":"draft","word_count":5,
  "total":{"currency":"EUR","amount_minor":100,"amount":"1.00"}
}}

Пример ответа сокращён. Всегда используйте фактическую цену и ID из ответа. Минимальная стоимость заказа — 1 евро.

2. Подтвердите стоимость и отправьте в работу

curl 'https://api.we-translate.biz/v1/order/in-work?id=DRAFT_ID' \
  -H "Authorization: Bearer $WT_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: submit-your-unique-reference-001' \
  --data '{"quoted_amount_minor":100}'

Эта операция списывает сумму с вашего баланса и создаёт обычный заказ we-translate. Указывайте точное целое количество евроцентов из total.amount_minor. Ответ содержит числовой ID заказа, который виден и в кабинете.

3. Получите статус и результат

GET https://api.we-translate.biz/v1/order/view?id=ORDER_ID
Authorization: Bearer YOUR_API_KEY

Статусы: waiting, translating, returned, moderation, complete. Поле translated_text возвращается только после завершения и подтверждения перевода. Допустим также ID исходного черновика. Для обновления статуса достаточно одного запроса раз в 30–60 секунд.

Методы

Метод	Путь	Назначение
GET	`/user/view`	Ваш ID, логин и баланс
GET	`/order/get-data-for-create-order`	Языки, направления, ставки и типы услуг
POST	`/order/quote`	Расчёт без сохранения; поля как у черновика
POST	`/order/create-as-draft`	Создать черновик
POST	`/order/in-work?id=DRAFT_ID`	Оплатить и отправить в очередь
GET	`/order/view?id=ORDER_ID`	Ваш заказ и готовый результат
GET	`/order/index?page=1&per_page=20`	Ваши неудалённые заказы в основной таблице; до 100 на странице
POST	`/order/delete?id=DRAFT_ID`	Отменить неоплаченный черновик; тело {}

Исторические заказы, перенесённые в архив, пока не включены в этот список. Заказ в работе отменяется через поддержку.

Повторные запросы и ошибки

Для создания, отправки и отмены черновика обязателен заголовок Idempotency-Key: 16–128 символов A–Z, a–z, 0–9, точки, двоеточия, дефисы или подчёркивания. Для каждой новой операции используйте новый ключ. Если ответ потерян, повторите ту же операцию с теми же параметрами и тем же ключом.

Повторное подтверждение уже отправленного черновика не создаёт новый заказ и не списывает деньги повторно. При изменённых параметрах с прежним ключом возвращается 409. Просроченный черновик нужно создать заново и проверить новую цену.

401 — неверный, отозванный или просроченный ключ.
402 — недостаточно средств.
403 / 404 — недостаточно прав или ваш заказ не найден.
409 — конфликт повторного запроса, цены или состояния.
422 — проверьте параметры.
429 — лимит 60 запросов на ключ и 20 POST-запросов на аккаунт в минуту; учитывайте Retry-After.
503 — временная ошибка; для повторения списания сохраните прежний Idempotency-Key.

Каждый ответ содержит request_id для обращения в поддержку. Время — UTC, суммы amount_minor — целые евроценты. API не фиксирует вход в веб-кабинет. Ключи перестают действовать после смены пароля.

Текст неотправленных черновиков удаляется через семь дней. Технический журнал запросов хранится 90 дней; содержимое переводов и ключи в него не записываются.