Locaties
Locatie ophalen
Eén testlocatie ophalen op 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"]
}
Haal één locatie op. Deze heeft dezelfde structuur als een item uit
Locaties ophalen. De
url van een location.*
webhook-event verwijst hiernaar.
Vereist de scope locations_view of appointments_schedule.
Verzoek
Padparameters
Respons
Bij succes geeft de API200 OK terug met het locatieobject.
Deelstaat of provincie. Kan
null zijn als de stad geen gekoppelde deelstaat heeft (bijv. stadstaten
of niet-gekoppelde imports).De ISO 3166-2-code van de deelstaat zonder het landvoorvoegsel (bijv.
BW voor Baden-Württemberg). Kan
null zijn.Wekelijkse openingstijden. Elke sleutel voor een weekdag (
monday–sunday) verwijst naar een array van
tijdvakken met openings- en sluitingstijd. Een lege array betekent dat de locatie die dag gesloten is. Het hele object is null
als er geen openingstijden beschikbaar zijn voor de locatie.Hoe het bloed hier tijdens een afspraak wordt afgenomen, tenzij de afspraak een eigen
draw_method instelt:
capillary (vingertop of bovenarm, in microtainers) of venous (uit de ader, in buisjes).De afnamemethoden waarvoor de locatie afnamemateriaal op voorraad heeft, gesorteerd. Een afspraak hier kan alleen een
van deze methoden instellen als
draw_method.Foutresponsen
| Status | Beschrijving |
|---|---|
400 | De id is geen UUID. |
401 | De API-sleutel ontbreekt of is ongeldig. |
403 | Je API-sleutel heeft niet de vereiste scope. |
404 | De locatie bestaat niet, is inactief of valt buiten je toegang. |
500 | Interne serverfout. |
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"]
}