A tárolók neve az időpont előnézetében terméknév lesz
A következő kiadástól acontainers[].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.Az Aniva mostantól az EU összes nyelvén működik, sőt még néhány másikon is
- Admin panel, weboldal, súgóközpont és dokumentáció: mind a 32 nyelven.
- Profilok: állítsd be minden páciens nyelvét. Az eredmények oldal és az eredményekről szóló e-mailek ezt követik.
Egyetlen Panelek listázása végpont
- A Panelek listázása mostantól visszaadja a
biomarker_groupsmezőt. Használd ezt az/api/v2/panelshelyett. - A Panel létrehozása megszűnt. Használd az Admin panelt.
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.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:- Szállítmányok listázása
- Otthoni tesztkészlet-rendelések listázása
- Időpontok listázása
- Profilok listázása
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.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 újaniva_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.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ő.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ásik409 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ésorder_in_flight: a laboratórium már megkaphatta a rendelést, ezért a kódnak a csövön kell maradnia.
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 adelivery_address mezőt.- A
country_codekisbetű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_codeszükséges. Más értékekre400a válasz. - A
postal_codekörüli szóközöket tárolás előtt eltávolítjuk.
Ú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, areplaces_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.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_emailsmező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.
A páciens adja meg a születési dátumát és a nemét
Mostantól engedélyezhetjük a profilcsoportodnak, hogydate_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.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ényfault á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.Logaritmikus mértékegységek
A Mértékegységek listázása egy harmadikunit_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.Otthoni tesztkészlet árajánlata a díjakkal együtt
A Kosár árajánlata elfogadja afulfilment 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.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.Egy nap időpontjainak listázása
Az Időpontok listázása két új szűrőt fogad el. Adate
(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.A duplikált profilokat elutasítjuk
A Profil létrehozása mostantól409-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.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.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 areference_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 alab_reported.reference_rangemezőt.not_measured: az eredményundeliverable.
null. Lásd:
Eredmények.Kiskereskedelmi árak és koordináták
- A helyszínek mostantól tartalmazzák a
state_code,latitudeéslongitudemezőket. - A Kiskereskedelmi árak listázása és a Kiskereskedelmi árak lekérése visszaadja minden egyes panel árát, amelyet egy gyógyszertár a betérő vásárlóknak értékesít.
- A
location.retail_prices.updatedwebhook értesít, ha megváltozik egy ár.
retail_prices_view scope szükséges.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.Á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, atotal_with_fees_centsés minden biomarkersoron egyname. - A listázásokban a
rate_cardaz Árlista lekéréseidértékét veszi át.
prices_view scope.További dokumentumadatok
Az Eredmények lekérése mindendocuments 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.
results.updated eseményt küld, például a Labor Quade végleges
lelete (_E) az előzetes (_V) után.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_managescope 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.completedjelzi, hogy az eredmények véglegesek. - A
location.*,profile.*ésshipment.*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áskorshipment.<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 egyresults.updatedesemény mutat. - A Helyszín lekérése egy helyszínt ad vissza az
id-je alapján. Egylocation.*eseményurlmezője erre mutat.
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_viewscope-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 aresults_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.A címzett telefonszámának és e-mail-címének küldése minden tesztkészlettel
Ha egy otthoni tesztkészletdelivery_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.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.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 aresults_view scope szükséges, a tesztkészletek megtekintéséhez pedig otthoni tesztkészlet-jogosultság.Csak aktiválásra szolgáló API-kulcsok
Az újhome_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.A nem csak férfi vagy nő lehet
A Profil létrehozása és a Profil frissítése már nem fogadja el asex: 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.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. Azactivated_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.Aniva-tartományok az eredményekben
Az eredményvégpontok mostantól kitöltik areference_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.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. Abiomarker_ids adja meg, hogy a
laboratórium mit vizsgáljon újra.Lásd: Otthoni tesztkészlet-rendelések.Egy ár biomarkerenként és panelenként
A biomarkerek és a panelek egyetlenprice_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ő.
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.Idempotenciakulcsok
A profilok, időpontok, otthoni tesztkészlet-rendelések és szállítmányok létrehozó végpontjai elfogadnakIdempotency-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.
