Проекты через API

#Сценарий

Автоматизация «получили файлы → запустили перевод → получили результат»:

#1. Создать проект

curl -u "$ACCOUNT_ID:$API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Инструкция v2","sourceLanguage":"en","targetLanguages":["ru"]}' \
  https://app.plaia.ru/api/integration/v1/project/create

Модель запроса (обязательные поля, опции) — в Swagger: POST /api/integration/v1/project/create.

#2. Добавить документ

curl -u "$ACCOUNT_ID:$API_TOKEN" \
  -F "file=@document.docx" \
  https://app.plaia.ru/api/integration/v1/project/document?projectId=<PROJECT_ID>

#3. Подключить активы (если нужно)

• TM: POST /api/integration/v1/project/{projectId}/translationmemories
• Глоссарии: PUT /api/integration/v1/project/{projectId}/glossaries
• MT: POST /api/integration/v1/project/{projectId}/mt

#4. Назначить исполнителей

• Ручное: POST /api/integration/v1/document/assign
• Автоматическое: POST /api/integration/v1/project/{projectId}/assign
• Блоки по словам: POST /api/integration/v1/document/assignFreelancers

#5. Отследить готовность

• Статистика: GET /api/integration/v2/project/{projectId}/statistics
• Статус проекта: GET /api/integration/v1/project/{projectId}

#6. Экспортировать

# Создать задачу экспорта
curl -u "$ACCOUNT_ID:$API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"documentIds":["<DOC_ID>"]}' \
  https://app.plaia.ru/api/integration/v1/document/export
# Скачать по taskId
curl -u "$ACCOUNT_ID:$API_TOKEN" \
  https://app.plaia.ru/api/integration/v1/document/export/<TASK_ID>

#Вебхуки

Чтобы не опрашивать статусы, подключите callback (Callback (вебхуки)) — платформа сама уведомит о событиях.