Přejít na hlavní obsah
POST
Získej URL, která zobrazí laboratorní výsledky jednoho profilu jako stránku jen pro čtení. Otevři URL ve WebView své aplikace nebo v kartě prohlížeče. Volej tento endpoint ze svého serveru pokaždé, když uživatel otevře výsledky, a URL nikdy neukládej do mezipaměti. Vyžaduje oprávnění embed a results_view u skupiny profilů daného profilu. Aniva uděluje oprávnění embed na vyžádání. Bez jednoho z těchto dvou oprávnění požadavek vrátí 403.
URL funguje jen jednou a platí 5 minut. Po otevření stránka spustí 60minutovou relaci, která patří jen této stránce. Archivací svého API klíče zavřeš všechny otevřené stránky najednou.

Požadavek

Parametry cesty

string
povinné
Jedinečný identifikátor (UUID) profilu, jehož výsledky stránka zobrazuje.

Tělo požadavku

Tělo požadavku je volitelné. Bez něj URL otevře seznam biomarkerů v jazyce profilu.
string
Jazyk stránky: 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 nebo uk. Výchozí: jazyk profilu.
object
Stránka, kterou URL otevře. Výchozí: { "name": "biomarkers" }. Jakékoli jiné name vrátí 400.
object
Omezí každou stránku na jednu laboratorní zprávu profilu. Výchozí: všechny zprávy profilu. Pošli přesně jedno ze tří ID. Seznam, trend biomarkeru i Twin pak zobrazují výsledky pouze z této zprávy a stránka skryje filtr termínů. Uživatel s touto URL nemůže otevřít jinou zprávu.
object
Vzhled stránky. API ho přidá do URL jako parametry dotazu.
Parametry vzhledu můžeš k vrácené URL přidat i ručně, před fragment #token=: theme=light|dark, primary=<hex> a logo=0. Neplatnou hodnotu stránka ignoruje. Obrázek loga vždy pochází z tvé skupiny profilů, nikdy z URL.

Odpověď

Při úspěchu vrátí API 201 Created.
string
povinné
URL stránky. Spouštěcí token je ve fragmentu #token=, takže ho prohlížeč nikdy nepošle na server. Otevři ji jednou.
string
povinné
Časový údaj ve formátu ISO 8601, po kterém už URL nelze otevřít.
Relace není vázaná na jednu stránku. Uvnitř vloženého zobrazení může uživatel přejít ze zobrazení Twin na biomarker a mezi seznamem a stránkami s detaily. Stránka zobrazuje pouze laboratorní výsledky: nezobrazuje hodnoty, které Aniva vypočítá, ani soubory, chat nebo nastavení.

Chybové odpovědi