id локации, чтобы планировать записи типа practitioner.
Твой API-ключ возвращает только локации в рамках твоего партнёрского доступа. Используй
GET /api/v1/locations, чтобы получить список всех доступных тебе локаций.location.* сообщает тебе, когда локация появляется, изменяется или исчезает.
Поля
Штат или провинция (определяется через связанный с городом регион). Может быть null, если у
города нет связанного региона.
Код региона по ISO 3166-2 без
префикса страны (например,
BW для Баден-Вюртемберга). Может быть null.Двухбуквенный код страны по ISO 3166-1 alpha-2
(например,
DE, US). Может быть null.Идентификатор часового пояса IANA для локации (например,
Europe/Berlin, America/New_York).
Используй его, чтобы отображать запланированное время в правильном местном времени. Может быть null.Еженедельные часы работы локации. Каждый ключ дня недели (
monday–sunday) соответствует массиву
интервалов времени { open, close } в 24-часовом формате HH:MM. Пустой массив означает, что в
этот день локация закрыта. Может быть null, если для локации нет данных о часах работы.Как здесь выполняется забор крови во время записи, если в самой записи не задан свой
draw_method:
capillary (из пальца или плеча, в микротейнеры) или venous (из вены, в пробирки).Способы забора крови, для которых в локации есть контейнеры, в отсортированном порядке. Для записи
здесь можно указать только один из них в качестве
draw_method.Доступность
Полеopen_hours выше описывает статичное еженедельное расписание работы. Чтобы показать реальные доступные слоты — и избежать двойной записи поверх уже существующих записей Aniva — вызови Получение доступности для нужной локации и передай диапазон дат, который хочешь отобразить. Этот эндпоинт — правильный источник данных для любого интерфейса записи: он разворачивает open_hours в сетку слотов локации, применяет исключения по датам, вычитает уже занятые записи и учитывает минимальный срок до записи.
Розничные цены
Аптека сама устанавливает цену на каждую панель и каждый отдельный биомаркер, которые продаёт клиентам без записи. Ты увидишь цену только после того, как аптека её опубликует. Список розничных цен возвращает их для всех доступных тебе локаций, а Получение розничных цен — для одной локации. Для обоих нужно разрешениеretail_prices_view; locations_view их не включает. Запроси оба разрешения для
одних и тех же локаций.
Вебхук location.retail_prices.updated сообщает тебе об изменении цены.
location.created и location.deactivated сообщают, когда локация появляется или исчезает. Изменение
списка панелей, которые предлагает локация, может дойти до тебя позже изменения цены, поэтому запрашивай
Список розничных цен повторно раз в день.