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

Типовой сценарий: создать проект, загрузить документ, назначить исполнителей, отследить готовность.

## Сценарий

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

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

```bash
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. Добавить документ

```bash
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. Экспортировать

```bash
# Создать задачу экспорта
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 (вебхуки)](/article/api-callbacks)) — платформа сама уведомит о событиях.