Интеграции

Откройте центр интеграции панели администратора, чтобы подключить EventHub, соединители хранилища данных и консоль API. Доступность зависит от плана и развертывания.

Хаб Integrations в панели администратора — это место, где администраторы подключают PetroBench к корпоративным системам данных и открывают API Console для организации.

Эта панель администратора находится в разработке и может пока появиться не во всех организациях. Когда он будет включен для вашего плана, вы найдете его в разделе Admin Panel > API & Integrations. Руководства по глубокой настройке находятся в разделе [Корпоративные интеграции] (/enterprise/integrations).

Открытая интеграция

  1. Переключитесь на Admin Panel.
  2. Откройте API & Integrations > Overview (метка может отображаться как Integrations).
  3. Просмотрите рекомендуемые соединители и списки категорий («Нефть и газ», «Облако и данные», «Идентификация и доступ» и связанные группы).

В хабе отображаются итоговые данные по доступным и подключенным интеграциям, когда у вашей организации есть доступ.

Чем вы здесь управляете

ПлощадьЦель
Connector catalogПросмотрите интеграции, доступные вашей организации
Connection statusПосмотрите, какие разъемы включены или появятся в ближайшее время
EventHubОткрытая конфигурация синхронизации и журналы для активного подключения к хранилищу
API ConsoleТокены служб, веб-перехватчики, использование и конфигурации клиентских подключений

Персональные ключи API по-прежнему находятся в разделе Настройки. Центр панели администратора — это поверхность разработчика на уровне организации.

EventHub и синхронизация хранилища

Для EventHub, Snowflake и связанных с ними рабочих процессов синхронизации используйте руководства Enterprise:

Из панели администратора вы обычно:

  1. Откройте подключенную интеграционную карту.
  2. Просмотрите сопоставления полей, расписание синхронизации и журналы последней синхронизации.
  3. Разрешение проверок соответствия оборудования, когда соединитель ставит в очередь совпадения с низкой достоверностью.

Совпадения оборудования с более низким уровнем достоверности из входящей синхронизации ставятся в очередь на проверку администратора, чтобы инженеры не получили молча о неправильной насосной установке или классе штанги.

Консоль API

API Console — это встроенная в приложение домашняя страница для доступа к API организации. Откройте Admin Panel > API & Integrations > API Console.

Он включает в себя четыре вкладки:

ВкладкаЦель
Service TokensВыпускайте и управляйте токенами, принадлежащими подразделениям, для серверов и рабочих мест
WebhooksРегистрация конечных точек HTTP для событий платформы
UsageОбъем текущих запросов, лимиты плана и ежемесячные квоты
ConnectГотовая к копированию конфигурация для CLI, клиентов MCP и REST

Использование

Usage показывает объем запросов API, квоты и потребление токенов за текущий период.

Типичные карты включают в себя:

  • Количество организационных и личных запросов, среднее время ответа и частота ошибок.
  • Plan limits — количество запросов в минуту, агрегат деления, одновременные запуски, дневной лимит токенов
  • Monthly quotas — чтение, запись, запуск моделирования и доставка через веб-перехватчик.
  • Daily activity плюс верхние конечные точки и потребители при наличии трафика.

Используйте эту вкладку при диагностике ограничений скорости, давления квот или непредвиденных ошибок API. См. также Ограничения скорости.

Токены обслуживания

Service Tokens — это долгосрочные учетные данные, принадлежащие division, а не человеку. Они продолжают работать после ухода создателя.

Создайте токен службы

  1. Перейдите к Admin Panel > API & Integrations > API Console.
  2. Откройте вкладку Service Tokens.
  3. Нажмите Create service token.
  4. Введите Token name (например, Nightly Snowflake Sync).
  5. Выберите Expiration (30 дней, 90 дней или 1 год).
  6. При желании установите IP allowlist.
  7. Выберите Permissions (области действия) для скважин, моделирования, оборудования и организации.
  8. Нажмите Create service token.
  9. Немедленно скопируйте токен открытого текста — он отображается только один раз.

В меню строк вы можете переименовать, повернуть или отозвать токен. В каждом подразделении имеется ограниченное количество активных жетонов (в списке указано общее количество использованных).

Предпочитайте сервисные токены для запланированных заданий и интеграций. Предпочитайте [персональные ключи API] (/docs/ru/settings/profile) только в том случае, если один инженер вызывает API в интерактивном режиме.

Полная информация об аутентификации: [Аутентификация API] (/enterprise/api/authentication).

Вебхуки

Webhooks регистрирует конечные точки HTTP, которые PetroBench вызывает при возникновении событий (например, well.created или simulation.failed).

  1. Откройте вкладку Webhooks.
  2. Нажмите Add Webhook.
  3. Введите URL-адрес конечной точки и выберите события.
  4. Сохраните, затем используйте элемент управления отправкой/тестированием, чтобы проверить доставку.

Соединять

Вкладка Connect помогает вам указать CLI, клиенты MCP (Claude, ChatGPT, Cursor), cURL или Python в вашем рабочем пространстве. Скопируйте конфигурацию своего клиента, а затем замените заполнитель ключа API токеном службы или личным ключом.

Пошаговую настройку клиента см. в разделах Начало работы и Справочник по MCP.

Кто может получить доступ

ДействиеАдминистратор штаб-квартирыАдминистратор отделаАдминистратор региона
Просмотреть Центр интеграцииДаЗависит от планаНет
Настройка EventHubДаЗависит от планаНет
Открытая консоль API (использование, подключение)ДаДа (собственное подразделение)Нет
Управление токенами обслуживанияДаДа (собственное подразделение)Нет
Управление веб-перехватчикамиДаДа (собственное подразделение)Нет

Связанный

На этой странице