Ugrás a fő tartalomhoz
API

A tárolók neve az időpont előnézetében terméknév lesz

A következő kiadástól a containers[].name az Időpont előnézetében a cső termékneve lesz. A type nem változik, ezért a type értékét olvasd, ha az alkalmazásod összehasonlítja a tárolókat.
Admin panelAPI

Az Aniva mostantól az EU összes nyelvén működik, sőt még néhány másikon is

API

Egyetlen Panelek listázása végpont

  • A Panelek listázása mostantól visszaadja a biomarker_groups mezőt. Használd ezt az /api/v2/panels helyett.
  • A Panel létrehozása megszűnt. Használd az Admin panelt.
API

Laboreredmények megjelenítése az alkalmazásodban

A pácienseid mostantól az alkalmazásodban is láthatják a laboreredményeiket: a biomarkerlistát, az egyes biomarkerek trendjét és egy 3D Twint egészségügyi területenkénti osztályzattal. Az oldal a márkád színét és logóját használja, világos vagy sötét módban.Az eredményoldal fizetős kiegészítő, az árát az Anivánál lévő kapcsolattartód tudja megmondani. A Beágyazási munkamenet létrehozása megmutatja, hogyan állíthatod be.
API

A listázó API-lekérdezések legfeljebb 5 percig gyorsítótárba kerülnek

Ez a négy végpont mostantól legfeljebb 5 percig gyorsítótárazza a válaszát, így egy módosítás megjelenése akár 5 percig is eltarthat:A Get végpontok továbbra is azonnal mutatják a módosításokat.Ha rendszeresen lekérdezed az API-t a változások figyeléséhez, használj inkább webhookokat. A webhook minden változásról azonnal értesít, amint az megtörténik. Lásd: Ismételt lekérdezések.
Admin panel

Nézd meg, mikor jön a futár a mintákért

Az admin panel mostantól mutatja a következő futáros felvételt a rendelődben, követéssel és címkével együtt.Admin panel, a tetején egy sávval: A GO! holnap érkezik ~10:00–12:00.Admin panel, a tetején egy sávval: A GO! holnap érkezik ~10:00–12:00.
API

Már elérhetők az Aniva tartományok

Az eredményeid mostantól tartalmazhatják az Aniva tartományokat is: egy általános és egy szűkebb tartományt minden biomarkerhez, az Aniva által rögzített forrásokkal együtt. A tartományok életkor, nem és terhességi hét szerint eltérnek.A hozzáféréshez írd alá az Aniva tartományokról szóló rövid megállapodást. Ezután bekapcsoljuk őket az API-kulcsodhoz. Kérd el a megállapodást az Anivánál lévő kapcsolattartódtól.A tartományok az új aniva_range mezőben találhatók. Ez váltja fel a reference_range_aniva mezőt, amely mindig null volt. A tartományok általános tájékoztatásul szolgálnak. Nem értékelik az eredményt, és nem minősülnek orvosi tanácsnak vagy orvostechnikai eszköznek. A laboratórium tartománya marad az irányadó. Lásd: Aniva tartományok.
API

A fluoridos cső mostantól fluoride

A Tárolók előnézete a fluoridos csövet fluoride néven adja meg. A régi érték naf volt. Ha a kódod a container.type mezőt a naf értékkel veti össze, módosítsd fluoride értékre.Két új érték jelenhet meg: lihep_capillary és fluoride_capillary. Ezek a kapilláris lítium-heparinos cső és a kapilláris fluoridos cső.
API

Nincs több dupla foglalás az utolsó idősávra

Ha egyszerre két foglalás érkezik egy idősáv utolsó helyére, csak az egyik sikerül. A másik 409 választ kap, akárcsak bármely betelt idősáv esetén. Ugyanez érvényes akkor is, ha egy időpontot lemondás vagy megerősítés közben módosítanak.A Vérvétel megerősítése három új 409 okkal bővült:
  • remapped: a kód mostantól más panelekhez van rendelve, mint korábban.
  • sent_to_lab és order_in_flight: a laboratórium már megkaphatta a rendelést, ezért a kódnak a csövön kell maradnia.
APIOtthoni tesztkészletek

Szigorúbb szállítási címek az otthoni tesztkészlet-rendeléseknél

Az Otthoni tesztkészlet létrehozása és az Otthoni tesztkészlet frissítése szigorúbban ellenőrzi a delivery_address mezőt.
  • A country_code kisbetűvel is megadható, pl. de. Az Aniva nagybetűvel tárolja és adja vissza.
  • A német címekhez (DE) pontosan 5 számjegyű postal_code szükséges. Más értékekre 400 a válasz.
  • A postal_code körüli szóközöket tárolás előtt eltávolítjuk.
AdminfelületOtthoni tesztkészletekAPI

Új tesztkészlet a hozzánk visszaküldött helyett

Ha a futár visszaküld hozzánk egy tesztkészletet, már nem várjuk meg a dobozt. Jelezd, ha újra kéred a készletet, és azonnal küldünk egy újat. Magad is létrehozhatod: hívd meg az Otthoni tesztkészlet létrehozása végpontot, a replaces_home_kit_order_id értékeként pedig add meg a visszaküldött készletet. Az új készlet külön rendelés, új készletkóddal.Amikor megérkezik a visszaküldött doboz, ellenőrizzük. Ezután a visszaküldött készlet cancelled állapotra vált, és látod, mi volt a dobozban.
EredményekAPIAdminfelület

E-mail a csapatodnak, ha elkészültek az eredmények

Kérd tőlünk, hogy állítsunk be egy alapértelmezett e-mail-címet a profilcsoportodhoz, például a csapataid postafiókját. Így erre a címre érkezik e-mail, amikor egy új foglalás eredményei elkészülnek. Ez az adminfelületről, az API-ból és a pácienseidtől érkező foglalásokra is vonatkozik.Ha egy foglalásnál módosítani szeretnéd:
  • Adminfelület: szerkeszd az e-mail-címeket, vagy kapcsold ki az „E-mail küldése, ha elkészültek az eredmények” opciót.
  • API: küldj egy listát a results_ready_emails mezőben, hogy helyette ezeket az e-mail-címeket használjuk. Ha meg szeretnéd tartani az alapértelmezett e-mail-címedet, vedd bele a listába. Ha nem szeretnél e-mailt, küldj [] értéket.
Lásd: E-mailek az eredmények elkészültekor.
APIOtthoni tesztkészletek

A páciens adja meg a születési dátumát és a nemét

Mostantól engedélyezhetjük a profilcsoportodnak, hogy date_of_birth és sex nélkül hozzon létre profilt. A páciens mindkettőt a készlet aktiválási oldalán adja meg, a születési dátumot pedig kétszer kell beírnia. Kérd tőlünk a bekapcsolását. Lásd: Profilok.
Adminfelület

Gyorsabb adminfelület

Az adminfelület mostantól 1,3 s helyett körülbelül 0,2 s alatt jeleníti meg az első tartalmat. Nincs több betöltőikon. Az oldalak fokozatosan töltődnek fel, ahogy megérkeznek az adatok. Az oldalak már akkor elkezdenek betöltődni, amikor egy link fölé viszed az egeret.
AdminfelületOtthoni tesztkészletekWebhookok

Hozzánk visszaküldött tesztkészletek

Ha a futár visszaküld hozzánk egy tesztkészletet, az mostantól megjelenik az Otthoni tesztkészletek oldalon. Szűrj a Visszaküldve állapotra, hogy lásd az összes készletet, amelyet a futár visszaküldött hozzánk, a futár indoklásával együtt. A küldemény fault állapotban zárul és shipment.fault eseményt vált ki, már nem delivered állapotban. Miután kinyitottuk a dobozt, azt is látod, mi volt benne: teljes, hiányzik egy része, vagy felbontott. Ez alapján el tudod dönteni, hogy az ügyfeled teljes visszatérítést kap-e.Szeretnéd, ha újra kiküldenénk a tesztkészletet? Írj nekünk a készletkóddal és a helyes szállítási címmel. Ugyanazzal a készletkóddal adjuk fel.
API

Logaritmikus mértékegységek

A Mértékegységek listázása egy harmadik unit_type értéket is visszaad: a logarithmic típust az olyan értékekhez, amelyek egy mennyiség logaritmusai, például a pH vagy az aterogén index. Megjelenítéskor kezeld úgy, mint a physical típust. Ne skálázd: két logaritmikus mértékegység eltolásban, nem pedig szorzóban tér el egymástól.
APIÁrazás

Otthoni tesztkészlet árajánlata a díjakkal együtt

A Kosár árajánlata elfogadja a fulfilment mezőt. Küldj home_kit értéket egy country_code kóddal, és az árajánlat tartalmazni fogja azokat a készlettételeket, amelyeket a havi számlád egy rendelésnél felszámol: a tesztkészlet díját, a mintavételi eszközöket, az oda-vissza postaköltséget az adott országba, a védőtokot és a tartalék lándzsás tasakot. Az alapértelmezett továbbra is a helyszíni draw az időpont díjaival. A válasz a fulfilment.kind mezőben jelzi, hogy melyiket árazta be.
Concierge

Ismerd meg az Aniva Concierge-et

Mostantól a változásnaplónk a velünk közös Slack-csatornádban is megjelenik, amint kiadunk valamit.Elkészítettük az Aniva Concierge-et is. Kérdésed van az API-val vagy az adminfelülettel kapcsolatban? Említsd meg @Aniva-t a Slackben, vagy egyszerűen válaszolj egy változásnapló-bejegyzés alatt. Átnézi a dokumentációnkat, és megmondja, hova kattints az adminfelületen, vagy melyik végpontot és szűrőket használd, az oldalra mutató linkkel együtt.
APIIdőpontok

Egy nap időpontjainak listázása

Az Időpontok listázása két új szűrőt fogad el. A date (YYYY-MM-DD) egy naptári napot ad vissza, az egyes időpontok helyszínének időzónája szerint, a legkorábbival kezdve. A location_id egyetlen vizsgálati helyszínt ad vissza. Használd mindkettőt egy helyszín mai beosztásához.
APIProfilok

A duplikált profilokat elutasítjuk

A Profil létrehozása mostantól 409-es kódot ad vissza error_name: "duplicate_profile_error" hibával, ha a kulcsod által látható profilok között már van egy azonos keresztnevű, vezetéknevű, nemű és születési dátumú profil. A válasz megadja a meglévő profile_id azonosítót. Használd azt ahelyett, hogy második profilt hoznál létre. A sandbox vezetéknevek kivételt képeznek.
Helyszínek

Bezár az Aniva Berlin Mitte

Az Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) 2026. november 1-jétől már nem kínál időpontokat. A legközelebbi helyszín az Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
AdminfelületÁrazás

Tesztkatalógus a saját áraiddal

Az adminfelület új Tesztkatalógus oldala minden biomarkert felsorol a hozzá tartozó laborokkal, csövekkel és a díjszabásod szerinti árával együtt.
APIEredmények

Miért nincs labortartomány egy eredménynél

Az Eredmények lekérése és az otthoni tesztkészletekhez tartozó Laboreredmények lekérése minden klinikai eredménye mostantól tartalmazza a reference_range_lab_absent_reason mezőt. Ez megmondja, miért null a reference_range_lab:
  • not_provided: nem létezik tartomány. Jelenítsd meg a „Nem alkalmazható” szöveget.
  • lab_text_only: a labor csak szöveget tüntetett fel, például célértéket vagy kockázati szintet. Jelenítsd meg a lab_reported.reference_range mezőt.
  • not_measured: az eredmény undeliverable.
Ha van tartomány, az értéke null. Lásd: Eredmények.
APIHelyszínek

Kiskereskedelmi árak és koordináták

A kiskereskedelmi árak végpontjaihoz és eseményéhez a retail_prices_view scope szükséges.
Otthoni tesztkészletekAdminfelület

Otthoni tesztkészletek rendelése az adminfelületen

Mostantól az adminfelület Otthoni tesztkészletek oldalán is rendelhetsz otthoni tesztkészletet a páciensednek. Válaszd ki vagy hozd létre a pácienst, válaszd ki a készletet, és add meg a szállítási címet. Ugyanitt le is mondhatsz egy tesztkészletet.
APIÁrazás

Árlista és árajánlatok

  • Az Árlista lekérése visszaadja az Aniva katalógusára érvényes áraidat és a díjaidat.
  • A Kosár árazása időpont nélkül árazza be a paneleket és a biomarkereket.
  • A Kosár árazása és az Időpont előnézete számláján mostantól szerepel a fees, a total_with_fees_cents és minden biomarkersoron egy name.
  • A listázásokban a rate_card az Árlista lekérése id értékét veszi át.
Mindkét új végponthoz szükséges a prices_view scope.
APIEredmények

További dokumentumadatok

Az Eredmények lekérése minden documents bejegyzése mostantól a következőket tartalmazza:
  • file_name: a Dokumentum letöltése által használt név.
  • Új: original_file_name, origin, content_type, etag, size_bytes.
Egy lecserélt lelet-PDF mostantól results.updated eseményt küld, például a Labor Quade végleges lelete (_E) az előzetes (_V) után.
APIWebhookok

Webhookok

Az Aniva mostantól meghívja a szerveredet, ha egy időpont, egy otthoni tesztkészlet-rendelés, annak eredményei, egy helyszín, egy profil vagy egy küldemény megváltozik. Már nem kell folyamatosan lekérdezned.
  • Regisztrálj egy HTTPS URL-t a Webhook létrehozása segítségével. Ehhez a webhooks_manage scope szükséges. Kérd meg az Anivát, hogy adja hozzá a kulcsodhoz, vagy állítsa be neked a webhookot.
  • Az események lefedik az időpontok és az otthoni tesztkészlet-rendelések minden állapotát, az új időpontot vagy helyszínt, valamint az eredmények minden változását. A results.completed jelzi, hogy az eredmények véglegesek.
  • A location.*, profile.* és shipment.* események jelzik, ha egy helyszín, egy profil vagy egy küldemény megjelenik, megváltozik vagy megszűnik. Egy küldemény minden állapotváltozáskor shipment.<status> eseményt is küld.
  • Az események azonosítókat és állapotokat tartalmaznak, laborértékeket vagy személyes adatokat soha. Kérd le az eseményben lévő url-t az adatokhoz.
  • Minden kérés a Standard Webhooks sémával van aláírva.
  • Az Aniva egy sikertelen kézbesítést körülbelül három nap alatt 10 alkalommal próbál újra. A kézbesítéseket 30 napig listázhatod és újraküldheted.
  • Az Eredmények lekérése minden eredménye mostantól rendelkezik egy id-vel, így frissítheted azt az eredményt, amelyre egy results.updated esemény mutat.
  • A Helyszín lekérése egy helyszínt ad vissza az id-je alapján. Egy location.* esemény url mezője erre mutat.
Lásd: Webhookok.
EredményekAdmin panel

Eredmények küldése e-mailben az ügyfélnek

Mostantól e-mailben értesítheted az ügyfelet, hogy elkészültek a laboreredményei. Küldd el az admin panel Laboreredmények oldaláról, vagy két új végponton keresztül: Eredmények küldése e-mailben időpontokhoz és Eredmények küldése e-mailben otthoni tesztkészlet-rendelésekhez.
  • Az e-mailhez PDF-fájlként csatolhatók a laborleletek. Minden PDF jelszóval védett: a jelszó az ügyfél születési dátuma 8 számjeggyel (DDMMYYYY), és ezt az e-mail is jelzi.
  • Hozzáadhatsz egy legfeljebb 1 000 karakteres személyes megjegyzést.
  • A profil elsődleges profilcsoportjának nevét és logóját jeleníti meg, a profil nyelvén.
  • Minden küldés egy e-mailt jelent. Az újrapróbálkozás egy másodikat küld. Ehhez az ügyfélhez szükséged van a results_view scope-ra.

E-mail értesítés, amikor az eredmények elkészülnek

Amikor időpontot foglalsz vagy otthoni cseretesztkészletet rendelsz az admin panelen, bekapcsolhatod az „E-mailt kérek, ha az eredmények elkészülnek” opciót. Ekkor egy e-mailt küldünk neked vagy bármely általad megadott címre, amint minden laboreredmény beérkezett. Az e-mail az admin panelen lévő eredményre mutat. Az ügyfél nem kapja meg ezt az e-mailt. Az adott ügyfélhez a results_view scope szükséges.Az API-n keresztül legfeljebb 5 címet adhatsz meg a results_ready_emails mezőben az Időpont létrehozása, az Otthoni tesztkészlet-rendelés létrehozása, az Időpont frissítése és az Otthoni tesztkészlet-rendelés frissítése végpontokon.
Otthoni tesztkészletek

A címzett telefonszámának és e-mail-címének küldése minden tesztkészlettel

Ha egy otthoni tesztkészlet delivery_address mezője tartalmaz phone vagy email adatot, továbbítjuk azokat a futárszolgálatnak. A futárszolgálat ekkor értesíti a címzettet, amikor a csomag úton van vagy átvételi ponton várakozik. Ha kihagyod őket, a futárszolgálat nem kap elérhetőséget, még akkor sem, ha a profilban szerepel. Te döntöd el, ki kapjon futárértesítéseket. Az értesítésben az Aniva Health szerepelhet feladóként.Lásd: Otthoni tesztkészlet-rendelés létrehozása.
Helyszínek

Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim és Wiesbaden

Négy új helyszín vénás vérvételhez. Lásd: Helyszínek listázása.
Admin panel

Laboreredmények oldal

Az admin panel új Laboreredmények oldala listázza az összes vérvételt és minden aktivált otthoni tesztkészletet a laborleleteivel együtt. Kereshetsz név, születési dátum vagy cső vonalkódja alapján. Ehhez a results_view scope szükséges, a tesztkészletek megtekintéséhez pedig otthoni tesztkészlet-jogosultság.
Otthoni tesztkészletek

Csak aktiválásra szolgáló API-kulcsok

Az új home_kit_orders_activate scope lehetővé teszi, hogy egy kulcs kizárólag otthoni tesztkészleteket aktiváljon, mást ne. Nem tud tesztkészletet létrehozni, módosítani vagy lemondani. Kérj ilyen kulcsot az Anivától, ha külön rendszer aktiválja a tesztkészleteidet.Lásd: Otthoni tesztkészlet-rendelés aktiválása.
APIKompatibilitástörő

A nem csak férfi vagy nő lehet

A Profil létrehozása és a Profil frissítése már nem fogadja el a sex: 0 (ismeretlen) értéket. Küldj 1-et férfi vagy 2-t nő esetén; a 0 értéknél 400 a válasz. A laboratóriumnak szüksége van a nemre a referenciatartományokhoz, és az ezt nélkülöző profilhoz tartozó rendelés nem tudott eljutni a laboratóriumba.Lásd: Profil létrehozása.
Otthoni tesztkészletek

Aktiválás nélkül a laboratóriumba érkező tesztkészletek

Ha egy minta a tesztkészlet aktiválása előtt érkezik meg a laboratóriumba, az Aniva aktiválja a tesztkészletet. Az activated_at a visszaküldött csomag első nyomkövetési eseményének reggele, vagy nyomkövetés hiányában annak a napnak a reggele, amikor a minta megérkezett a laboratóriumba. Egy későbbi, eltérő activated_at értékkel küldött aktiválási hívás 409-et ad vissza.Lásd: Otthoni tesztkészlet-rendelés aktiválása.
API

Aniva-tartományok az eredményekben

Az eredményvégpontok mostantól kitöltik a reference_range_aniva mezőt az Aniva által összeállított összehasonlító értékekkel, az eredmény mértékegységére átszámítva. Az értékek életkor, nem és terhességi hét szerint eltérnek. A kulcsodhoz az ANIVA_REFERENCE_RANGES_VIEW scope szükséges. Enélkül a mező értéke null.Lásd: Időpont eredményeinek lekérése.
APIOtthoni tesztkészletek

Cseretesztkészletek

Rendelj cserekészletet, ha egy tesztkészlet nem tudta az összes eredményt biztosítani. A csere egy új rendelés új laborkóddal, és megtartja az eredeti rendelés paneljét. A biomarker_ids adja meg, hogy a laboratórium mit vizsgáljon újra.Lásd: Otthoni tesztkészlet-rendelések.
APIÁrazásKompatibilitástörő

Egy ár biomarkerenként és panelenként

A biomarkerek és a panelek egyetlen price_cents értéket tartalmaznak az árlistád szerint, mellette pedig a retail_cents szerepel:
  • > 0: önállóan rendelhető.
  • 0: arányszám (lásd: requires), vagy csak más markerekkel együtt rendelhető (lásd: positions).
  • null: nincs árazva, így nem rendelhető.
Kompatibilitástörő változás: eltávolítottuk a groups[] mezőt a listákból és az időpont-előnézetből. A retail és a yours ármezőt is eltávolítottuk.Lásd: Árazás.
API

Idempotenciakulcsok

A profilok, időpontok, otthoni tesztkészlet-rendelések és szállítmányok létrehozó végpontjai elfogadnak Idempotency-Key fejlécet. Az azonos kulccsal indított újrapróbálkozás az első választ adja vissza, és nem ír semmit.Lásd: Idempotencia.
Helyszínek

Aniva Hannover, Düsseldorf, Duisburg és Essen

Négy új németországi Aniva-helyszín nyílt meg vénás vérvételre: Hannover, Düsseldorf, Duisburg és Essen. Hívd meg a Helyszínek listázása végpontot, hogy lásd a kulcsoddal foglalható helyszíneket.