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 — виклич Get Availability для цієї локації та передай діапазон дат, який хочеш відобразити. Саме цей ендпоїнт є правильним джерелом істини для будь-якого інтерфейсу запису: він розгортає open_hours на сітку слотів локації, застосовує винятки для конкретних дат, віднімає вже зайняті записи та враховує мінімальний час попередження.
Роздрібні ціни
Аптека встановлює власну ціну для кожної панелі та кожного окремого біомаркера, які продає відвідувачам без попереднього запису. Ти побачиш ціну лише після того, як аптека її опублікує. List Retail Prices повертає їх для кожної локації, до якої ти маєш доступ на читання, а Get Retail Prices — для однієї локації. Обом потрібен дозвілretail_prices_view; locations_view їх не включає. Запитуй обидва
дозволи для тих самих локацій.
Вебхук location.retail_prices.updated повідомляє тобі, коли змінюється
ціна. location.created і location.deactivated повідомляють, коли локація з’являється або
зникає. Зміна набору панелей, які пропонує локація, може надійти до тебе пізніше, ніж зміна ціни,
тому повторно зчитуй List Retail Prices раз на день.