#Лимиты и ограничения

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

#Форматы и длины полей

Превышение любого из этих значений вернёт 422 с разбивкой по полям в объекте errors.

Уникальность fields[].id — единственное ограничение из таблицы, которое не приводит к 422. Если в бланке два поля с одним id, приём врача не срывается: мы берём первое вхождение, остальные пропускаем, а в ответе возвращаем предупреждение duplicate_field_id. Подробнее: Дубликаты id в бланке.

#Частота запросов к Smartica

Лимиты считаются на пару «клиника + ключ», в минуту.

Отдельно ограничены неудачные попытки авторизации — 30 в минуту на клинику. Если вы упёрлись в этот лимит, значит ключ неверен: перебор не поможет, проверьте секрет.

При превышении приходит 429 с заголовком Retry-After. Дождитесь указанного времени. Не запускайте цикл немедленных повторов — он только продлит блокировку.

#Как выбрать частоту опроса при pull

Лимит в 60 запросов к списку в минуту — это потолок, а не рекомендация. На практике достаточно опрашивать список статуса ready раз в 30–60 секунд на клинику. Заполнение протокола занимает от десятков секунд до нескольких минут, поэтому более частый опрос ничего не ускорит.

#Время жизни и задержки

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

Timeout в 30 секунд — это верхний предел, за которым мы считаем запрос неуспешным, а не ориентир. Ваши GET и PUT должны отвечать за доли секунды: читать готовые данные и быстро сохранять payload. Тяжёлую обработку выполняйте после того, как надёжно приняли данные и ответили 200.

#Окно списка записей

Запрос с since глубже 90 дней вернёт 422. Записи старше этого окна через партнёрский API недоступны.

#Лимит перезаполнений

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

При достижении лимита приём переходит в статус failed. Это защита от бесконечного цикла: в нормальной работе врач не приближается к этому числу.

#Ротация ключа

При выпуске нового API-ключа клиники предыдущий продолжает работать 72 часа. За это время пропишите новый ключ во всех окружениях вашей МИС.

После истечения окна старый ключ перестаёт действовать: SSO начнёт возвращать 401, а при pull протоколы перестанут забираться.

#Что не входит в контракт

#Повторная доставка

Контракт не гарантирует автоматический повтор каждого неуспешного запроса. Фактические способы повторения:

• после ошибки GET врач заново открывает приём;
• после ошибки PUT врач нажимает повтор отправки в интерфейсе Smartica;
• новая запись или перезаполнение в том же приёме порождает новый PUT.

Отсюда два обязательных требования к вашей стороне: PUT должен быть идемпотентным по encounter_id, и МИС не должна рассчитывать на фиксированное число попыток.

Подробнее: Авторизация, ошибки и повторная доставка.

#Требования к вашему endpoint

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

• Авторизация, ошибки и повторная доставка
• Глоссарий и правила идентификаторов
• Import: импорт из Smartica
• Диагностика: если что-то не работает