Создание интеграции
1. Откройте раздел интеграций
В левом меню админ-панели Bito перейдите в Интеграция → Интеграция и нажмите Кастомная интеграция. В окне Создание интеграции выберите тип:
- Внешняя интеграция — только API: ваш код работает на ваших серверах. Нажмите + Создать в этой строке; эта страница описывает именно этот путь.
- Интеграция с собственным кодом — та же форма плюс
widget.zip, который выполняется внутри Bito. См. виджет для своего аккаунта.
2. Заполните форму
На этом этапе обязательно только название, но для публичной карточки понадобится почти всё остальное. Любое поле можно изменить позже — только пока карточка на проверке (pending), изменения отклоняются.
| Поле | Обязательно | Описание |
|---|---|---|
name | Да | Название по языкам, которое видно в маркетплейсе. Заполните хотя бы один язык — остальные копируются из первого заполненного. |
description | Нет | Описание по языкам, которое видно до установки. |
thumbnail | Нет | Ссылка на логотип. Сначала загрузите изображение — форма вернёт ссылку. |
role_id | Нет | Устаревшее поле (в форме — Роль интеграции). Запрос интеграции выполняется от имени владельца аккаунта, поэтому эта роль не ограничивает доступ; поле оставлено только для старых клиентов, которые его ещё отправляют. Ограничивайте доступ через required_permissions. |
required_permissions | Нет | Список прав ERP, которыми интеграция пользуется в Integration API (те же ключи, что у ролей). Клиент видит именно этот список перед установкой, установка закрепляет его за интеграцией, и каждый вызов проверяется по нему. Пустой или неотправленный список — все права. В обычной форме этого поля нет; оно задаётся в Мои приложения → приложение → Основная информация или через API. |
redirect_uri | Для OAuth | Ваш HTTPS-адрес. Bito отправляет сюда код авторизации, когда клиент устанавливает интеграцию. См. хуки установки. |
revoke_access_hook_uri | Настоятельно рекомендуется | Ваш HTTPS-адрес для уведомлений об удалении. Без него вы не узнаете, что клиент удалил интеграцию. |
webhook_uri | Нет | Адрес для вебхуков данных. При каждой установке Bito автоматически подписывает его на события create/update/delete ряда коллекций. Адреса также можно регистрировать через API — см. вебхуки данных. |
iframe.url | Для виджета | Страница, которую Bito встраивает во вкладку настроек вашей интеграции, с одноразовым токеном. Пользовательский виджет работает не так. |
ip_whitelist | Нет | Список разрешённых адресов: одиночный IPv4 или подсеть CIDR, не больше 50. Пока список пуст, ключи принимаются с любого адреса; если он заполнен, запрос к Integration API с другого адреса отклоняется с 403. Редактируется в поле IP whitelist формы; у приложения разработчика — в Мои приложения → приложение → Ключи → Разрешённые IP-адреса. |
duplicate_control | Нет | Применять ли контроль дублей к записям, которые создаёт интеграция. |
multiple_sources | Нет | Работает ли интеграция одновременно с другими источниками тех же данных. |
WARNING
Все адреса должны быть https:// и доступны из интернета. Bito отклоняет loopback-адреса, адреса внутренних сетей, адреса метаданных облака и ссылки с логином и паролем внутри.
3. Сохраните и скопируйте ключи
Нажмите Сохранить. Окно Интеграция создана покажет client_id, secret и api_key — secret больше нигде увидеть нельзя. См. Ключи доступа.
4. Установите интеграцию
Созданная интеграция не установлена, и каждый запрос к API с её ключами возвращает ошибку Integration is not installed. Откройте интеграцию в списке Установлены на странице Интеграция и нажмите Установить. Установка отправляет хук установки и создаёт подписку webhook_uri.