#Тестовая площадка

У Smartica два независимых контура: тестовый — Smartica Lab — и рабочий. Разработку и приёмочный прогон делайте на тестовом, а на рабочий переходите, когда всё сошлось.

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

#Адреса

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

# Рабочий контур
curl --request POST \
  --header 'Authorization: Bearer <API-ключ клиники>' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"user_email":"doctor@clinic.ru","user_full_name":"Иванов Иван Иванович","encounter_id":"12345"}' \
  'https://app.smartica.ai/api/v1/integrations/{platform}/sso/token'

# Тестовый контур: отличается только хост
curl --request POST \
  --header 'Authorization: Bearer <тестовый API-ключ клиники>' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"user_email":"doctor@clinic.ru","user_full_name":"Иванов Иван Иванович","encounter_id":"12345"}' \
  'https://app.smarticalab.com/api/v1/integrations/{platform}/sso/token'

Ссылка для входа врача приходит с того же адреса, в который вы обратились. Открывайте её как есть, не подменяя домен.

#Контуры полностью разделены

Ключ тестового контура на рабочем даёт 401, а platform, зарегистрированный только на тестовом, на рабочем даёт 404.

Такое разделение — не формальность: именно оно не даёт тестовому прогону записать выдуманный диагноз в реальную карту пациента.

#Данные на тестовой площадке

Не отправляйте на тестовый контур персональные данные пациентов и записи настоящих приёмов. Используйте выдуманные ФИО и постановочные разговоры.

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

#Ваша сторона тоже удваивается

Секреты, которыми Smartica авторизуется в вашей МИС, должны различаться по контурам: тестовая площадка Smartica обращается к тестовой МИС, рабочая — к рабочей. Требования к секретам — в статье Авторизация, ошибки и повторная доставка.

Адрес Smartica и API-ключ храните в конфигурации или переменных окружения, а не в коде. Тогда переключение контура — это смена двух значений, а не правка и повторная сборка.

#Переход на рабочий контур

Что поменять:

• базовый адрес — на https://app.smartica.ai;
• API-ключ клиники — на рабочий;
• секрет, которым Smartica обращается к вашему GET и PUT, — на рабочий;
• адреса вашего GET и PUT — на боевые, и сообщить их нам.

Что останется прежним: пути запросов, формат тела и ответов, названия полей, коды ошибок, лимиты и, как правило, platform.

Перед переключением убедитесь, что пройден приёмочный прогон, а в рабочем контуре ваша клиника уже зарегистрирована: без этого запросы будут возвращать 404, каким бы правильным ни выглядел адрес.

После переключения прогоните один контрольный приём на рабочем контуре: врач входит по кнопке, протокол доходит до карты. Это занимает несколько минут и снимает почти все вопросы первого дня.

#Если что-то не сходится

Проверьте в первую очередь, что адрес и ключ относятся к одному и тому же контуру: перепутанные окружения — самая частая причина 401 и 404 на старте.

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

#Связанные статьи

• Подключение партнёра
• Быстрый старт
• Авторизация, ошибки и повторная доставка
• Диагностика: если что-то не работает