Контрольный список перед запуском

Используйте этот контрольный список перед включением партнерской интеграции для рабочих объектов.

Настройка Partner Console

• Профиль партнера заполнен полностью.
• URL-адрес логотипа, сайт, категория и описание указаны верно.
• Настроен способ связи данных: Direct Link или Linking Identifier.
• Связь с объектами проверена как минимум на одном реальном объекте.
• Используется правильный тип ключа:
  • Dryrun для тестирования записи без изменения данных.
  • Read-only для безопасного получения данных.
  • Live только тогда, когда вы готовы изменять рабочие данные.

Аутентификация и управление ключами

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

Проверка данных

• Для каждой вызываемой конечной точки указаны обязательные поля.
• Идентификаторы объектов соответствуют настроенному способу связи.
• Идентификаторы из вашей системы стабильны и не меняются между синхронизациями.
• Крупные импорты разбиты на пакеты в пределах документированных ограничений.
• Элементы пакетов с ошибками можно определить и отправить повторно.

Тестирование конечных точек

Перед запуском протестируйте все конечные точки, от которых зависит ваша интеграция:

• Организации и объекты успешно считываются.
• Участники сохраняются и обновляются.
• Планы членства, зоны доступа и часы доступа синхронизируются правильно.
• Посещения принимаются и могут быть сопоставлены с записями в вашей системе.
• Снимки отчетов используют ожидаемый отчетный период и показатели.
• Процессы Door/Gate Controller, где это применимо, протестированы на реальном оборудовании.

Готовность Access Time Windows

Если интеграция передает Access Time Windows:

• Примеры абсолютных и еженедельных окон проходят контрольный список сертификации поставщика данных.
• Значения эпохи передаются как целые числа секунд Unix без кавычек; точные границы [from, to) протестированы.
• Проверены значения UTC по умолчанию, пользовательские часовые пояса IANA интеграции и соответствующие переходы на летнее время.
• Один надежный монотонный поток ревизий по участнику и источнику координирует инкрементные обновления, сверку и повторные попытки.
• Операторы понимают поведение при опущенном значении, полной замене, идемпотентном повторе, конфликте, устаревших данных и явном [].
• Для каждого scope_key, включая default, есть утвержденное сопоставление в Performance Hub; проверено, что неизвестные ключи приводят к отказу в доступе.
• Настроены ожидаемая частота обновления интеграции, максимальная давность исходных данных, поведение при устаревшем источнике и оповещения.
• Доказано, что ошибка получения данных из вышестоящего источника не приводит к отправке пустого или неполного снимка.
• Сходимость потоков по этапам, отмена или отзыв доступа и границы начала и окончания для физических дверей соответствуют согласованным целевым показателям.
• Обычные правила и постоянные разрешения проверены как резервные варианты, и окна не могут обойти отключение пользователя, blockAllAccess, режим обслуживания или геозонирование.

Готовность контроля доступа

Для интеграций контроля доступа:

• Ваша система принимает решение о доступе до вызова Performance Hub.
• Интеграция обрабатывает device_offline, maintenance_mode_active и unlock_confirmation_timeout.
• Операторы понимают, что тайм-аут означает, что разблокировка не подтверждена.
• В ваших журналах сохраняются возвращаемые event_id и command_id.
• У персонала объекта есть ручной резервный процесс.

Обработка ошибок и повторные попытки

• Ответы 400, 401, 403, 404, 409 и 422 передаются операторам или службе поддержки, а не повторяются вслепую.
• Для ответов 429, 500, 502, 503 и 504 используется логика ограниченных повторных попыток с задержкой.
• Повторяющиеся ошибки вызывают оповещение в вашей системе.
• Интеграция никогда не отбрасывает записи с ошибками без уведомления.

Наблюдаемость

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

Запуск в рабочей среде

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

После выполнения этих проверок ваша настроенная интеграция появится в каталоге партнеров Performance Hub внутри основной платформы Performance Hub.