Lieux
Lister les lieux
Récupérer tous les lieux de test disponibles pour ta clé API
GET
/
api
/
v1
/
locations
curl --request GET \
--url https://anivahealth.com/api/v1/locations \
--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"]
},
{
"id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",
"name": "Aniva Helsinki Central",
"company_name": "Aniva Oy",
"street": "Mannerheimintie",
"house_number": "12",
"address_line_2": null,
"city": "Helsinki",
"state": "Uusimaa",
"state_code": "18",
"postal_code": "00100",
"country_name": "Finland",
"country_code": "FI",
"timezone": "Europe/Helsinki",
"latitude": 60.169405,
"longitude": 24.938365,
"contact_phone": "+358912345678",
"email": "helsinki@anivahealth.com",
"website": "https://anivahealth.com",
"google_maps_url": "https://maps.google.com/?q=Mannerheimintie+12+Helsinki",
"image_url": "https://cdn.anivahealth.com/locations/helsinki-central.jpg",
"open_hours": {
"monday": [{ "open": "07:30", "close": "17:00" }],
"tuesday": [{ "open": "07:30", "close": "17:00" }],
"wednesday": [{ "open": "07:30", "close": "17:00" }],
"thursday": [{ "open": "07:30", "close": "17:00" }],
"friday": [{ "open": "07:30", "close": "15:00" }],
"saturday": [],
"sunday": []
},
"default_draw_method": "venous",
"draw_methods": ["venous"]
}
]
Récupère tous les lieux de test actifs accessibles avec ta clé API. Utilise l’
id d’un lieu renvoyé lors de la création d’un rendez-vous avec Créer un rendez-vous.
Nécessite le scope locations_view ou appointments_schedule.
Requête
Cet endpoint ne prend aucun paramètre de requête.Réponse
En cas de succès, l’API renvoie200 OK avec un tableau d’objets lieu.
État ou province. Peut être
null quand la ville n’a pas d’État associé (par ex. villes-États ou
imports non associés).Code ISO 3166-2 de l’État sans le préfixe pays (par ex.
BW pour le Bade-Wurtemberg). Peut être
null.Horaires d’ouverture hebdomadaires. Chaque clé de jour de la semaine (
monday–sunday) correspond
à un tableau de plages horaires d’ouverture et de fermeture. Un tableau vide signifie que le lieu
est fermé ce jour-là. L’objet entier est null quand les horaires ne sont pas disponibles pour le
lieu.Comment la prise de sang est effectuée lors d’un rendez-vous dans ce lieu, sauf si le rendez-vous
définit son propre
draw_method : capillary (au bout du doigt ou dans le haut du bras, dans des
microtubes) ou venous (dans la veine, dans des tubes).Les méthodes de prise de sang pour lesquelles le lieu dispose de contenants, triées. Un
rendez-vous dans ce lieu ne peut définir que l’une d’entre elles comme
draw_method.Réponses d’erreur
| Statut | Description |
|---|---|
403 | Interdit — ta clé API n’a pas accès à cette opération. |
500 | Erreur interne du serveur. |
curl --request GET \
--url https://anivahealth.com/api/v1/locations \
--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"]
},
{
"id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",
"name": "Aniva Helsinki Central",
"company_name": "Aniva Oy",
"street": "Mannerheimintie",
"house_number": "12",
"address_line_2": null,
"city": "Helsinki",
"state": "Uusimaa",
"state_code": "18",
"postal_code": "00100",
"country_name": "Finland",
"country_code": "FI",
"timezone": "Europe/Helsinki",
"latitude": 60.169405,
"longitude": 24.938365,
"contact_phone": "+358912345678",
"email": "helsinki@anivahealth.com",
"website": "https://anivahealth.com",
"google_maps_url": "https://maps.google.com/?q=Mannerheimintie+12+Helsinki",
"image_url": "https://cdn.anivahealth.com/locations/helsinki-central.jpg",
"open_hours": {
"monday": [{ "open": "07:30", "close": "17:00" }],
"tuesday": [{ "open": "07:30", "close": "17:00" }],
"wednesday": [{ "open": "07:30", "close": "17:00" }],
"thursday": [{ "open": "07:30", "close": "17:00" }],
"friday": [{ "open": "07:30", "close": "15:00" }],
"saturday": [],
"sunday": []
},
"default_draw_method": "venous",
"draw_methods": ["venous"]
}
]
⌘I
curl --request GET \
--url https://anivahealth.com/api/v1/locations \
--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"]
},
{
"id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",
"name": "Aniva Helsinki Central",
"company_name": "Aniva Oy",
"street": "Mannerheimintie",
"house_number": "12",
"address_line_2": null,
"city": "Helsinki",
"state": "Uusimaa",
"state_code": "18",
"postal_code": "00100",
"country_name": "Finland",
"country_code": "FI",
"timezone": "Europe/Helsinki",
"latitude": 60.169405,
"longitude": 24.938365,
"contact_phone": "+358912345678",
"email": "helsinki@anivahealth.com",
"website": "https://anivahealth.com",
"google_maps_url": "https://maps.google.com/?q=Mannerheimintie+12+Helsinki",
"image_url": "https://cdn.anivahealth.com/locations/helsinki-central.jpg",
"open_hours": {
"monday": [{ "open": "07:30", "close": "17:00" }],
"tuesday": [{ "open": "07:30", "close": "17:00" }],
"wednesday": [{ "open": "07:30", "close": "17:00" }],
"thursday": [{ "open": "07:30", "close": "17:00" }],
"friday": [{ "open": "07:30", "close": "15:00" }],
"saturday": [],
"sunday": []
},
"default_draw_method": "venous",
"draw_methods": ["venous"]
}
]