#Тестовая площадка
У smartica.ai два независимых контура. Тестовый контур называется Smartica Lab. Второй контур рабочий. Разработку и приёмочный прогон делайте на тестовом контуре. На рабочий контур переходите, когда приёмочный прогон пройден.
При переходе меняются только адрес и секреты. Пути, формат запросов, названия полей и коды ошибок в обоих контурах одинаковые. Интеграцию переписывать не нужно.
#Адреса
| Контур | Базовый адрес smartica.ai |
|---|---|
| Тестовый (Smartica Lab) | https://app.smarticalab.com |
| Рабочий | https://app.smartica.ai |
Все примеры в документации написаны для рабочего адреса. Чтобы получить тестовый запрос, замените только хост:
# Рабочий контур
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'
Ссылка для входа врача приходит с того же адреса, в который вы обратились. Открывайте ссылку как есть. Домен не подменяйте.
#Контуры полностью разделены
| Что | Как связано между контурами |
|---|---|
| API-ключ клиники | Свой в каждом контуре. Ключи не взаимозаменяемы |
| Аккаунты врачей | Не переносятся. Врач с тестового контура не появляется на рабочем |
| Записи и протоколы | Не переносятся |
| Шаблоны и бланки | Настраиваются отдельно |
platform |
Обычно совпадает. Если для вашей клиники platform различается, мы скажем при выдаче ключа |
Ключ тестового контура на рабочем даёт 401. platform, зарегистрированный только на тестовом, на рабочем даёт 404.
Разделение контуров не даёт тестовому прогону записать выдуманный диагноз в реальную карту пациента.
#Данные на тестовом контуре
Не отправляйте на тестовый контур персональные данные пациентов и записи настоящих приёмов. Используйте выдуманные ФИО и постановочные разговоры.
Тестовый контур обновляется вместе с разработкой. Контур может ненадолго становиться недоступным. Данные на контуре могут очищаться без предупреждения. Не храните на тестовом контуре ничего, что нужно сохранить.
#Секреты вашей МИС
Секреты, которыми smartica.ai авторизуется в вашей МИС, различаются по контурам. Тестовый контур smartica.ai обращается к тестовой МИС. Рабочий контур обращается к рабочей МИС. Требования к секретам в статье Авторизация и ошибки.
Адрес smartica.ai и API-ключ храните в конфигурации или в переменных окружения, не в коде. Для смены контура меняете два значения. Код править и собирать заново не нужно.
#Переход на рабочий контур
Что поменять:
- базовый адрес на
https://app.smartica.ai. - API-ключ клиники на рабочий.
- секрет, которым smartica.ai обращается к вашему
GETиPUT, на рабочий. - адреса вашего
GETиPUTна рабочие. Сообщите эти адреса нам.
Что остаётся прежним: пути запросов, формат тела и ответов, названия полей, коды ошибок, лимиты и, как правило, platform.
Перед переключением пройдите приёмочный прогон из статьи Подключение. В рабочем контуре клиника уже должна быть зарегистрирована. Без регистрации запросы возвращают 404, включая верный адрес.
После переключения прогоните один контрольный приём на рабочем контуре. Врач входит по кнопке. Протокол доходит до карты. Прогон занимает несколько минут.
#Если что-то не сходится
Сначала проверьте, что адрес и ключ относятся к одному контуру. Перепутанные контуры — самая частая причина 401 и 404 на старте.
В обращении в поддержку укажите контур, тестовый или рабочий. Без контура разбор занимает больше времени.