Passer au contenu principal
Un lieu est un centre de test physique où des prises de sang sont effectuées par des professionnels de santé. Tu utilises l’id d’un lieu pour planifier des rendez-vous practitioner.
Ta clé API renvoie uniquement les lieux compris dans ton contexte d’accès partenaire. Utilise GET /api/v1/locations pour lister tous les lieux qui te sont accessibles.
Un webhook location.* t’avertit lorsqu’un lieu apparaît, change ou disparaît.

Champs

string
requis
UUID du lieu. Passe-le en tant que location_id lors de la création d’un rendez-vous.
string
requis
Nom affiché du lieu.
string
Clinique ou entreprise qui exploite le lieu. Peut être null.
string
Nom de la rue, sans le numéro. Peut être null.
string
Numéro de rue. Peut être null.
string
Complément d’adresse — chez, bâtiment ou étage. Peut être null.
string
Ville. Peut être null.
string
État ou province (résolu via l’État rattaché à la ville). Peut être null lorsque la ville n’a pas d’État rattaché.
string
Code ISO 3166-2 de l’État sans le préfixe pays (par ex. BW pour Baden-Württemberg). Peut être null.
string
Code postal ou code ZIP. Peut être null.
string
Nom complet du pays (par ex. Germany). Peut être null.
string
Code pays à deux lettres selon ISO 3166-1 alpha-2 (par ex. DE, US). Peut être null.
string
Identifiant de fuseau horaire IANA du lieu (par ex. Europe/Berlin, America/New_York). Utilise-le pour afficher les horaires prévus à la bonne heure locale. Peut être null.
number
Latitude de l’adresse en degrés décimaux (WGS 84). Peut être null.
number
Longitude de l’adresse en degrés décimaux (WGS 84). Peut être null.
string
Numéro de téléphone du lieu. Peut être null.
string
Adresse e-mail du lieu. Peut être null.
string
URL du site web du lieu. Peut être null.
string
Lien direct vers le lieu sur Google Maps. Peut être null.
string
URL d’une photo du lieu. Peut être null.
object
Horaires d’ouverture hebdomadaires du lieu. Chaque clé de jour (monday–sunday) renvoie à un tableau de plages horaires { open, close } au format HH:MM (24 h). Un tableau vide indique que le lieu est fermé ce jour-là. Peut être null si les horaires ne sont pas disponibles pour ce lieu.
string
requis
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).
string[]
requis
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.
Utilise toujours le champ timezone pour convertir les dates et heures scheduled_at en heure locale avant de les afficher aux patients ou au personnel.

Disponibilité

Le champ open_hours ci-dessus décrit les horaires d’ouverture hebdomadaires fixes. Pour afficher de vrais créneaux réservables — et éviter les doublons avec les rendez-vous Aniva existants — appelle Obtenir les disponibilités pour le lieu et passe-lui la plage de dates que tu veux afficher. Cet endpoint est la bonne source de vérité pour toute interface de réservation : il déploie open_hours sur la grille de créneaux du lieu, applique les exceptions par date, soustrait les rendez-vous déjà réservés et applique le délai de préavis minimum.

Prix publics

Une pharmacie fixe son propre prix pour chaque panel et pour chaque biomarqueur individuel qu’elle vend aux clients de passage. Tu ne vois un prix qu’une fois que la pharmacie le publie. Lister les prix publics les renvoie pour tous les lieux que tu peux lire, et Obtenir les prix publics les renvoie pour un seul lieu. Les deux nécessitent le scope retail_prices_view ; locations_view ne les inclut pas. Demande les deux scopes sur les mêmes lieux. Un webhook location.retail_prices.updated t’informe quand un prix change. location.created et location.deactivated t’indiquent quand un lieu apparaît ou disparaît. Un changement dans les panels proposés par un lieu peut te parvenir après un changement de prix, relis donc Lister les prix publics une fois par jour.

Exemple de lieu