Перейти к основному содержанию
Локация — это физический пункт сдачи анализов, где медицинские специалисты проводят забор крови. Ты используешь id локации, чтобы планировать записи типа practitioner.
Твой API-ключ возвращает только локации в рамках твоего партнёрского доступа. Используй GET /api/v1/locations, чтобы получить список всех доступных тебе локаций.
Вебхук location.* сообщает тебе, когда локация появляется, изменяется или исчезает.

Поля

string
обязательно
UUID локации. Передавай его как location_id при создании записи.
string
обязательно
Отображаемое название локации.
string
Клиника или компания, управляющая локацией. Может быть null.
string
Название улицы без номера дома. Может быть null.
string
Номер дома. Может быть null.
string
Дополнительная строка адреса — c/o, корпус или этаж. Может быть null.
string
Город. Может быть null.
string
Штат или провинция (определяется через связанный с городом регион). Может быть null, если у города нет связанного региона.
string
Код региона по ISO 3166-2 без префикса страны (например, BW для Баден-Вюртемберга). Может быть null.
string
Почтовый индекс или ZIP-код. Может быть null.
string
Полное название страны (например, Germany). Может быть null.
string
Двухбуквенный код страны по ISO 3166-1 alpha-2 (например, DE, US). Может быть null.
string
Идентификатор часового пояса IANA для локации (например, Europe/Berlin, America/New_York). Используй его, чтобы отображать запланированное время в правильном местном времени. Может быть null.
number
Широта адреса в десятичных градусах (WGS 84). Может быть null.
number
Долгота адреса в десятичных градусах (WGS 84). Может быть null.
string
Номер телефона локации. Может быть null.
string
Адрес электронной почты локации. Может быть null.
string
URL сайта локации. Может быть null.
string
Прямая ссылка на локацию в Google Maps. Может быть null.
string
URL фотографии локации. Может быть null.
object
Еженедельные часы работы локации. Каждый ключ дня недели (monday–sunday) соответствует массиву интервалов времени { open, close } в 24-часовом формате HH:MM. Пустой массив означает, что в этот день локация закрыта. Может быть null, если для локации нет данных о часах работы.
string
обязательно
Как здесь выполняется забор крови во время записи, если в самой записи не задан свой draw_method: capillary (из пальца или плеча, в микротейнеры) или venous (из вены, в пробирки).
string[]
обязательно
Способы забора крови, для которых в локации есть контейнеры, в отсортированном порядке. Для записи здесь можно указать только один из них в качестве draw_method.
Всегда используй поле timezone, чтобы переводить значения даты и времени scheduled_at в местное время, прежде чем показывать их пациентам или сотрудникам.

Доступность

Поле open_hours выше описывает статичное еженедельное расписание работы. Чтобы показать реальные доступные слоты — и избежать двойной записи поверх уже существующих записей Aniva — вызови Получение доступности для нужной локации и передай диапазон дат, который хочешь отобразить. Этот эндпоинт — правильный источник данных для любого интерфейса записи: он разворачивает open_hours в сетку слотов локации, применяет исключения по датам, вычитает уже занятые записи и учитывает минимальный срок до записи.

Розничные цены

Аптека сама устанавливает цену на каждую панель и каждый отдельный биомаркер, которые продаёт клиентам без записи. Ты увидишь цену только после того, как аптека её опубликует. Список розничных цен возвращает их для всех доступных тебе локаций, а Получение розничных цен — для одной локации. Для обоих нужно разрешение retail_prices_view; locations_view их не включает. Запроси оба разрешения для одних и тех же локаций. Вебхук location.retail_prices.updated сообщает тебе об изменении цены. location.created и location.deactivated сообщают, когда локация появляется или исчезает. Изменение списка панелей, которые предлагает локация, может дойти до тебя позже изменения цены, поэтому запрашивай Список розничных цен повторно раз в день.

Пример локации