# Документы и экспорт через API

Работа с документами: получение, статистика, обновление, импорт переводов, XLIFF и экспорт.

## Методы документов

| Метод | Назначение |
| --- | --- |
| `GET /api/integration/v1/document` | Данные документа |
| `PUT /api/integration/v1/document/update` | Обновить документ |
| `PUT /api/integration/v1/document/rename` | Переименовать |
| `DELETE /api/integration/v1/document` | Удалить документ(ы) |
| `GET /api/integration/v1/document/statistics` | Статистика документа |
| `POST /api/integration/v1/document/complete` | Завершить документ |

## Импорт переводов

- `PUT /api/integration/v1/document/translate` — импортировать переводы из файла перевода.
- `PUT /api/integration/v1/document/translateWithXliff` — импорт из XLIFF (перевод делался вне платформы).
- Статус импорта: `GET /api/integration/v1/document/translate/status`; детальный отчёт: `GET /api/integration/v1/document/translate/result`.

Такие методы нужны при гибридных процессах: XLIFF уходит во внешний инструмент, возвращается с переводами.

## Экспорт

1. `POST /api/integration/v1/document/export` — создать задачу экспорта (указать документы и параметры).
2. `GET /api/integration/v1/document/export/{taskId}` — скачать результат по готовности.

Экспорт асинхронный:taskId проверяется повторно до готовности. При 409/202 — задача ещё выполняется ([Коды ошибок](/article/api-errors)).

## Назначения и этапы

- `POST /api/integration/v1/document/assign` — модель назначения лингвистов.
- `POST /api/integration/v1/document/assignVendors` — вендор на этап.
- `POST /api/integration/v1/document/setStageUnitCount` — объём этапа.
- `POST /api/integration/v1/document/assignFromMyTeam` — приглашения MyTeam.

Полный список — [/api](/api).