Standorte
Standort abrufen
Einen Teststandort anhand seiner ID abrufen
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"]
}
Rufe einen Standort ab. Er hat dieselbe Struktur wie ein Eintrag aus
Standorte auflisten. Die
url eines
Webhook-Events vom Typ location.* verweist hierher.
Erfordert den Scope locations_view oder appointments_schedule.
Anfrage
Pfadparameter
Antwort
Bei Erfolg gibt die API200 OK mit dem Standortobjekt zurück.
Bundesland oder Provinz. Kann
null sein, wenn der Stadt kein Bundesland zugeordnet ist (z. B.
Stadtstaaten oder nicht zugeordnete Importe).ISO-3166-2-Code des Bundeslands ohne Länderpräfix (z. B.
BW für Baden-Württemberg). Kann null
sein.Wöchentliche Öffnungszeiten. Jeder Wochentagsschlüssel (
monday–sunday) verweist auf ein Array
mit Zeitspannen aus Öffnungs- und Schließzeit. Ein leeres Array bedeutet, dass der Standort an
diesem Tag geschlossen ist. Das gesamte Objekt ist null, wenn für den Standort keine
Öffnungszeiten verfügbar sind.Wie das Blut bei einem Termin hier abgenommen wird, sofern der Termin keine eigene
draw_method
festlegt: capillary (Fingerkuppe oder Oberarm, in Mikrogefäße) oder venous (aus der Vene, in
Röhrchen).Die Abnahmemethoden, für die der Standort Gefäße vorrätig hat, sortiert. Ein Termin hier kann nur
eine davon als
draw_method festlegen.Fehlerantworten
| Status | Beschreibung |
|---|---|
400 | Die id ist keine UUID. |
401 | Der API-Schlüssel fehlt oder ist ungültig. |
403 | Dein API-Schlüssel hat nicht den erforderlichen Scope. |
404 | Der Standort existiert nicht, ist inaktiv oder liegt außerhalb deines Zugriffs. |
500 | Interner Serverfehler. |
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"]
}