Locații
Obține locația
Preia o locație de testare după ID-ul ei
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"]
}
Obține o locație. Are aceeași structură ca o intrare din
Listare locații. Câmpul
url al unui eveniment
webhook de tip location.* trimite aici.
Necesită scope-ul locations_view sau appointments_schedule.
Cerere
Parametri de cale
Răspuns
La succes, API-ul returnează200 OK cu obiectul locației.
Stat sau provincie. Poate fi
null când orașul nu are un stat asociat (de ex., orașe-stat sau
importuri nemapate).Codul ISO 3166-2 al statului fără prefixul de țară (de ex.,
BW pentru Baden-Württemberg). Poate
fi null.Programul săptămânal. Fiecare cheie de zi a săptămânii (
monday–sunday) corespunde unui array
de intervale orare de deschidere/închidere. Un array gol înseamnă că locația este închisă în acea
zi. Întregul obiect este null când programul nu este disponibil pentru locație.Modul în care se recoltează sângele la o programare aici, dacă programarea nu setează propriul
draw_method: capillary (din vârful degetului sau din partea superioară a brațului, în
microtuburi) sau venous (din venă, în eprubete).Metodele de recoltare pentru care locația are recipiente pe stoc, sortate. O programare aici
poate seta doar una dintre acestea ca
draw_method.Răspunsuri de eroare
| Status | Descriere |
|---|---|
400 | id nu este un UUID. |
401 | Cheia API lipsește sau nu este validă. |
403 | Cheia ta API nu are scope-ul necesar. |
404 | Locația nu există, este inactivă sau nu ai acces la ea. |
500 | Eroare internă de server. |
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"]
}