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.location.* t’avertit lorsqu’un lieu apparaît, change ou disparaît.
Champs
État ou province (résolu via l’État rattaché à la ville). Peut être null lorsque la ville n’a pas
d’État rattaché.
Code ISO 3166-2 de l’État sans le
préfixe pays (par ex.
BW pour Baden-Württemberg). Peut être null.Code pays à deux lettres selon ISO 3166-1 alpha-2
(par ex.
DE, US). Peut être null.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.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.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.Disponibilité
Le champopen_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 scoperetail_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.