# Интеграции: обзор

Типовые интеграции платформы: перевод Git-репозиториев, синхронизация с внешними системами, вебхуки.

## Варианты интеграции

1. **REST API** — любые сценарии: автоматическая загрузка контента, экспорт, синхронизация статусов (см. [Обзор API](/article/api-overview)).
2. **Callback (вебхуки)** — события платформы в вашу систему ([Callback](/article/api-callbacks)).
3. **XLIFF-обмен** — работа с внешними CAT-инструментами ([Документы через API](/article/api-documents)).
4. **Готовые сервисы** — например, автоматический перевод Git-репозиториев (git-pt) — уточняйте доступные коннекторы у поддержки.

## Типовые схемы

### Автолокализация контент-проекта

```
CMS/Git → API: project/create + document upload
       → Prettranslate (TM + MT)
       → Команда работает в редакторе
       → callback: экспорт готов
       → API: download export → обратно в CMS/Git
```

### Синхронизация клиентов и платежей

```
CRM → client/create (идемпотентно по имени)
    → project с привязкой клиента
    → quote → invoice → платежи (externalId)
```

### Внутренний сервис перевода

Сервис на вашем бэкенде использует API от лица аккаунта: проверка доступных MT-движков (`account/mtengines`), умный перевод (`smartTranslation/translate`), ведение проектов.

## Рекомендации

- Отдельный API-ключ на каждую интеграцию ([API-ключи](/article/api-keys)).
- Идемпотентность внешними ID и ретраи с бэкоффом ([Коды ошибок и ретраи](/article/api-errors)).
- Логи всех запросов/ответов — упростят отладку и обращения в поддержку.

Нужен коннектор под вашу систему — напишите в support@plaia.ru, опишите систему и желаемый сценарий.