Passer au contenu principal
POST
Obtiens une URL qui affiche les résultats de laboratoire d’un profil sur une page en lecture seule. Ouvre l’URL dans une WebView de ton application ou dans un onglet de navigateur. Appelle cet endpoint depuis ton serveur chaque fois que l’utilisateur ouvre les résultats et ne mets jamais l’URL en cache. Nécessite les scopes embed et results_view sur un groupe de profils du profil. Aniva accorde le scope embed sur demande. Sans l’un de ces deux scopes, la requête renvoie 403.
L’URL fonctionne une fois et pendant 5 minutes. À son ouverture, la page démarre une session de 60 minutes que seule cette page détient. Archive ta clé API pour fermer toutes les pages ouvertes d’un coup.

Requête

Paramètres de chemin

string
requis
Identifiant unique (UUID) du profil dont la page affiche les résultats.

Corps

Le corps est facultatif. Sans corps, l’URL ouvre la liste des biomarqueurs dans la langue du profil.
string
Langue de la page : en, bg, ca, cs, da, de, el, es, et, fi, fr, ga, hr, hu, is, it, lb, lt, lv, mt, nl, no, pl, pt, ro, ru, sk, sl, sr, sv, tr ou uk. Par défaut : la langue du profil.
object
La page qu’ouvre l’URL. Par défaut : { "name": "biomarkers" }. Tout autre name renvoie 400.
object
Limite chaque page à un seul rapport de laboratoire du profil. Par défaut : tous les rapports du profil. Envoie exactement un des trois ID. La liste, l’évolution d’un biomarqueur et le Twin n’affichent alors que les résultats de ce rapport, et la page masque le filtre de rendez-vous. L’utilisateur ne peut pas ouvrir un autre rapport avec cette URL.
object
L’apparence de la page. L’API l’ajoute à l’URL sous forme de paramètres de requête.
Tu peux aussi ajouter toi-même les paramètres d’apparence à une URL renvoyée, avant le fragment #token= : theme=light|dark, primary=<hex> et logo=0. La page ignore toute valeur invalide. L’image du logo provient toujours de ton groupe de profils, jamais de l’URL.

Réponse

En cas de succès, l’API renvoie 201 Created.
string
requis
L’URL de la page. Le jeton de lancement se trouve dans le fragment #token=, de sorte qu’un navigateur ne l’envoie jamais à un serveur. Ouvre-la une fois.
string
requis
Instant au format ISO 8601 après lequel l’URL ne peut plus être ouverte.
La session n’est pas liée à une seule page. Dans la vue intégrée, l’utilisateur peut passer du Twin à un biomarqueur, ainsi qu’entre la liste et les pages de détail. La page affiche uniquement les résultats de laboratoire : elle n’affiche pas les valeurs calculées par Aniva, les fichiers, le chat ni les paramètres.

Réponses d’erreur