Passer au contenu principal
PATCH
Ajoute un ou plusieurs biomarqueurs individuels à un rendez-vous comme analyses à la carte, en dehors de tout panel préconstruit. Les décisions de routage sont prises en aval par le pipeline logistique des commandes selon les correspondances par laboratoire de chaque biomarqueur. L’ensemble obtenu est validé de manière synchrone selon les règles de clôture de chaque laboratoire. Certains biomarqueurs ne peuvent être obtenus qu’en les commandant avec d’autres — un rapport LDL/HDL, par exemple, est fourni par une commande qui renvoie aussi LDL et HDL, donc demander le rapport seul ne constitue pas une commande cohérente. (Ce sont ces mêmes composants qui déterminent le prix du rapport — consulte le détail de pricing sur Lister les biomarqueurs.) Quand l’ensemble ne peut pas être commandé proprement, l’appel renvoie 400 avec un payload validation et rien n’est enregistré, ce qui te permet de procéder par essais et erreurs jusqu’à obtenir un ensemble valide :
  1. PATCH … { "biomarker_ids": [45] } (rapport LDL/HDL seul) → 400 ; validation.failures[].fix_options[].add_biomarkers liste LDL et HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (rapport + LDL + HDL) → 200.
La même boucle couvre les biomarqueurs qu’Aniva ne vend qu’au sein d’une position : demande-en un seul et l’appel renvoie 400 avec error: "biomarker_requires_position" et les positions qui le vendent. Consulte Tarification. Lister les biomarqueurs indique price_cents: null pour certains biomarqueurs. Ces biomarqueurs sont non configurés : Aniva n’a pas fixé leur prix. Si tu en ajoutes un, l’appel renvoie 400 avec error: "biomarker_not_priced". Aucun autre biomarqueur ne corrige cette erreur, car null signifie que tu n’as aucun prix pour acheter ce marqueur. Les marqueurs de kit font exception. Ajoute le panel correspondant au kit, et ses membres sont inclus avec le panel. L’appel accepte aussi un membre que tu ajoutes à un rendez-vous qui comporte déjà ce panel. Lors d’une prise de sang capillaire (draw_method: capillary), le prélèvement est réparti dans des microtainers. Les panels passent en premier, dans l’ordre de réservation. Les biomarqueurs individuels remplissent ensuite l’espace libre des microtainers des panels. Quand ils ont besoin de plus de place, ils ouvrent de nouveaux microtainers. Nous les répartissons équitablement. Chaque microtainer contient au maximum 150 µl de biomarqueurs individuels. Un biomarqueur qui nécessite plus de 150 µl dans un microtainer à lui seul ne rentre jamais, tout comme un biomarqueur sans volume renseigné. Si l’ensemble obtenu enfreint cette règle, l’appel renvoie 400 avec un message error et rien n’est enregistré. Cet appel est idempotent : les biomarqueurs déjà présents sur le rendez-vous sont conservés. Nécessite les scopes appointments_schedule et schedule_appointments_with_individual_biomarker_selection.
Tu ne peux plus ajouter de biomarqueurs après avoir appelé Confirmer la prise de sang. Toute tentative de modification d’un rendez-vous confirmé renvoie 409 Conflict.

Requête

Paramètres de chemin

string
requis
Identifiant unique (UUID) du rendez-vous.

Paramètres du corps

number[]
requis
Tableau d’ID de biomarqueurs à ajouter. Doit contenir au moins un élément. Utilise Lister les biomarqueurs pour trouver les ID.

Réponse

En cas de succès, l’API renvoie 200 OK pour confirmer que les biomarqueurs ont été ajoutés.
boolean
true lorsque les biomarqueurs ont été ajoutés au rendez-vous avec succès.

Lire un 400

Chaque 400 de validation de clôture ou de catalogue contient une phrase dans message. Un 400 de validation du corps ou de microtainer contient uniquement error. Base ta logique sur error. En cas d’échec de validation de clôture, error est une phrase. En cas d’échec lié au catalogue, error est un code machine : biomarker_not_priced ou biomarker_requires_position. Validation de clôture — l’ensemble ne peut être commandé proprement dans aucun laboratoire :
  • validation.failures[] — présent uniquement en cas d’échec de validation de clôture (absent sur les simples erreurs de validation du corps). Une entrée par groupe de biomarqueurs qu’aucun laboratoire ne peut traiter, contenant les biomarker_ids en échec et fix_options[], la plus petite option en premier. Le champ add_biomarkers ({ id, name }) de chaque option est un ensemble à ajouter EN ENTIER — garde tes biomarqueurs initiaux, ajoute ceux-là et réessaie. Un fix_options vide signifie qu’aucun ajout ne résoudra le problème ; supprime plutôt le biomarqueur.
Biomarqueur non tarifé — Aniva n’a pas fixé de prix pour ce biomarqueur. Lister les biomarqueurs l’indique avec price_cents: null, ou l’omet quand il s’agit d’un rapport ayant un composant non tarifé. error vaut biomarker_not_priced, et biomarker_id indique le marqueur. Aucun autre biomarqueur ne corrige cette erreur, supprime donc le biomarqueur. Deux conditions rendent un biomarqueur commandable : un laboratoire vers lequel Aniva peut router doit le fournir, et le catalogue Aniva doit le tarifer. Biomarqueur restreint — un biomarqueur vendu uniquement au sein d’une position, sans position qui le couvre dans l’ensemble. error vaut biomarker_requires_position, biomarker_id indique le marqueur et positions[] liste toutes les positions qui le vendent, la moins chère en premier. Ajoute tous les biomarqueurs de l’une d’entre elles. Consulte Tarification pour le modèle, et pricing.positions sur Obtenir un biomarqueur pour la liste complète des membres d’une position.

Réponses d’erreur