Локации
Получить локацию
Получить одну локацию для сдачи анализов по ее ID
GET
/
api
/
v1
/
locations
/
{id}
curl --request GET \
--url https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b \
--header 'x-api-key: YOUR_API_KEY'
{
"id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
"name": "Aniva Berlin Mitte",
"company_name": "Aniva GmbH",
"street": "Unter den Linden",
"house_number": "42",
"address_line_2": null,
"city": "Berlin",
"state": "Berlin",
"state_code": "BE",
"postal_code": "10117",
"country_name": "Germany",
"country_code": "DE",
"timezone": "Europe/Berlin",
"latitude": 52.517036,
"longitude": 13.388859,
"contact_phone": "+4930987654321",
"email": "berlin-mitte@anivahealth.com",
"website": "https://anivahealth.com",
"google_maps_url": "https://maps.google.com/?q=Unter+den+Linden+42+Berlin",
"image_url": "https://cdn.anivahealth.com/locations/berlin-mitte.jpg",
"open_hours": {
"monday": [{ "open": "08:00", "close": "18:00" }],
"tuesday": [{ "open": "08:00", "close": "18:00" }],
"wednesday": [{ "open": "08:00", "close": "18:00" }],
"thursday": [{ "open": "08:00", "close": "18:00" }],
"friday": [{ "open": "08:00", "close": "16:00" }],
"saturday": [],
"sunday": []
},
"default_draw_method": "venous",
"draw_methods": ["venous"]
}
Запроси одну локацию. Её структура совпадает с элементом
Списка локаций. Сюда ведёт
url события
вебхука location.*.
Требуется scope locations_view или appointments_schedule.
Запрос
Параметры пути
Ответ
В случае успеха API возвращает200 OK с объектом локации.
Штат или провинция. Может быть
null, если у города нет привязанного штата (например,
города-государства или несопоставленный импорт).Код штата по ISO 3166-2 без префикса страны (например,
BW для Баден-Вюртемберга). Может быть
null.Часы работы на неделю. Каждый ключ дня недели (
monday–sunday) соответствует массиву
интервалов открытия и закрытия. Пустой массив означает, что в этот день локация закрыта. Весь
объект равен null, если часы работы для локации недоступны.Как здесь выполняется забор крови во время записи, если в самой записи не задан свой
draw_method:
capillary (из пальца или плеча, в микротейнеры) или venous (из вены, в пробирки).Способы забора крови, для которых в локации есть контейнеры, в отсортированном порядке. Для записи
здесь можно указать только один из них в качестве
draw_method.Ответы с ошибками
| Статус | Описание |
|---|---|
400 | id не является UUID. |
401 | API-ключ отсутствует или недействителен. |
403 | У твоего API-ключа нет нужной области доступа. |
404 | Локация не существует, неактивна или недоступна тебе. |
500 | Внутренняя ошибка сервера. |
curl --request GET \
--url https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b \
--header 'x-api-key: YOUR_API_KEY'
{
"id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
"name": "Aniva Berlin Mitte",
"company_name": "Aniva GmbH",
"street": "Unter den Linden",
"house_number": "42",
"address_line_2": null,
"city": "Berlin",
"state": "Berlin",
"state_code": "BE",
"postal_code": "10117",
"country_name": "Germany",
"country_code": "DE",
"timezone": "Europe/Berlin",
"latitude": 52.517036,
"longitude": 13.388859,
"contact_phone": "+4930987654321",
"email": "berlin-mitte@anivahealth.com",
"website": "https://anivahealth.com",
"google_maps_url": "https://maps.google.com/?q=Unter+den+Linden+42+Berlin",
"image_url": "https://cdn.anivahealth.com/locations/berlin-mitte.jpg",
"open_hours": {
"monday": [{ "open": "08:00", "close": "18:00" }],
"tuesday": [{ "open": "08:00", "close": "18:00" }],
"wednesday": [{ "open": "08:00", "close": "18:00" }],
"thursday": [{ "open": "08:00", "close": "18:00" }],
"friday": [{ "open": "08:00", "close": "16:00" }],
"saturday": [],
"sunday": []
},
"default_draw_method": "venous",
"draw_methods": ["venous"]
}
⌘I
curl --request GET \
--url https://anivahealth.com/api/v1/locations/b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b \
--header 'x-api-key: YOUR_API_KEY'
{
"id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
"name": "Aniva Berlin Mitte",
"company_name": "Aniva GmbH",
"street": "Unter den Linden",
"house_number": "42",
"address_line_2": null,
"city": "Berlin",
"state": "Berlin",
"state_code": "BE",
"postal_code": "10117",
"country_name": "Germany",
"country_code": "DE",
"timezone": "Europe/Berlin",
"latitude": 52.517036,
"longitude": 13.388859,
"contact_phone": "+4930987654321",
"email": "berlin-mitte@anivahealth.com",
"website": "https://anivahealth.com",
"google_maps_url": "https://maps.google.com/?q=Unter+den+Linden+42+Berlin",
"image_url": "https://cdn.anivahealth.com/locations/berlin-mitte.jpg",
"open_hours": {
"monday": [{ "open": "08:00", "close": "18:00" }],
"tuesday": [{ "open": "08:00", "close": "18:00" }],
"wednesday": [{ "open": "08:00", "close": "18:00" }],
"thursday": [{ "open": "08:00", "close": "18:00" }],
"friday": [{ "open": "08:00", "close": "16:00" }],
"saturday": [],
"sunday": []
},
"default_draw_method": "venous",
"draw_methods": ["venous"]
}