Platform API referencia

A vitalera REST API 148 végpontot tesz elérhetővé 20+ erőforráscsoportban, a vitális jelek bevitelétől a gondozási terv életciklus-kezeléséig. Minden végpont JSON-t ad vissza, és RESTful konvenciókat követ FHIR R5-hez igazított adatmodellekkel.

Teljes API dokumentáció

Az interaktív API referencia kérés/válasz sémákkal, paraméter-részletekkel és példa payload-okkal az ügyfelek számára elérhető a vitalera dashboard-ban. Lépjen kapcsolatba az info@vitalera.io címmel a hozzáférésért.

Hitelesítés és felhasználók

Csoport	Végpontok	Leírás
JWT hitelesítés	4	JWT tokenek generálása, frissítése, érvényesítése és deaktiválása
Integrációs hitelesítés	1	SSO átirányítás külső identitásszolgáltatókhoz
Hitelesítő adatok kezelése	1	Alkalmazás ügyfél-hitelesítő adatok rotálása
Felhasználók és jogosultságok	1	Aktuális felhasználói jogosultságok és szerepkör-információk

Résztvevők

Csoport	Végpontok	Leírás
Monitorozottak (betegek)	10	Résztvevők létrehozása, listázása, frissítése, törlése. Listák exportálása, összefoglalók lekérése, gondozási hozzárendelések kezelése és alapértelmezett tervek lekérdezése.
Szakemberek	5	Egészségügyi szakemberek és gondozói csapattagok létrehozása, listázása, frissítése, törlése.
Monitorozó csapatok	1	Monitorozó csapattagok listázása tervdefiníció szerint.
Összefoglalók	1	Összesített számlálók a monitorozott résztvevők között.

Gondozási tervek és feladatok

Csoport	Végpontok	Leírás
Tervdefiníciók	11	Tervsablonok kezelése — listázás, lekérés, publikálás, visszavonás, felülvizsgálat. Akciók, alkalmazásbeállítások, szervezetek, profilmezők és érvényesítési állapot lekérdezése.
Monitorozott tervek	26	Teljes életciklus-kezelés — létrehozás, aktiválás, felfüggesztés, folytatás, befejezés, visszavonás. Monitorozó csapattagok, felülbírálatok, triggerek, eltérések, egyéni mezők kezelése és PDF jelentések generálása.
Feladatok	10	Klinikai és wellness feladatok kezelése — listázás, elfogadás, indítás, befejezés, törlés, meghiúsulás, elutasítás. Függőben lévő feladatszámlálók irányítópult-jelvényekhez.

Megfigyelések — Vitális jelek

Csoport	Végpontok	Leírás
Vérnyomás	2	Szisztolés, diasztolés és átlagos artériás nyomás
Pulzus	2	Folyamatos és alkalmankénti pulzusmérések
Oxigénszaturáció (SpO2)	2	Pulzoximéteres mérések
Hőmérséklet	2	Testhőmérséklet-mérések
Koleszterin	2	Össz-, LDL-, HDL-koleszterin panelek

Megfigyelések — Aktivitás és fitnesz

Csoport	Végpontok	Leírás
Lépésszám	2	Napi és napközi lépésadatok
Kalóriák	2	Aktív és összes kalóriafelhasználás
Távolság	2	Megtett távolság (séta, futás, kerékpározás)
Emeletek	2	Szintemelkedés és emeletek
Aktív percek	2	Napi aktív percek intenzitási zónák szerint
Edzések	2	Strukturált edzésfoglalkozások körökkel, HR zónákkal, tempóval
VO2 Max	2	Becsült maximális oxigénfelvétel

Megfigyelések — Alvás és felépülés

Csoport	Végpontok	Leírás
Alvási foglalkozások	3	Alvás időtartama, hatékonysága és foglalkozás-metaadatok
Alvási fázisok	2	Könnyű, mély, REM és éber fázis-bontások
Alvási légzés	2	Légzési gyakoriság és zavarok alvás közben
Stressz-pontszám	2	Napi stresszszintek és trendek
Felépülési pontszám	2	Edzés utáni felépülési készenlét
Terhelési pontszám	2	Kardiovaszkuláris terhelés az aktivitástól
Energiaszint	2	Body Battery / energiatartalék szintek

Megfigyelések — Specializált

Csoport	Végpontok	Leírás
Vércukor	2	Alkalmankénti vércukormérések
CGM mérések	2	Folyamatos glükózmonitorozási adatpontok
CGM összefoglalók	2	Tartományban töltött idő, átlagos glükóz, variabilitás
CGM riasztások	2	Magas/alacsony glükóz riasztási események
HRV	2	Szívfrekvencia-variabilitás (RMSSD, SDNN)
ECG	2	Elektrokardiogram hullámforma-adatok
Testösszetétel	2	Súly, testzsír %, izomtömeg, BMI
Bőrhőmérséklet	2	Folyamatos bőrhőmérséklet-mérések
Csúcs kilégzési áramlás	2	Asztma és COPD monitorozás
Légzési frekvencia	2	Légzési frekvencia mérések
Spirometria	2	FEV1, FVC és egyéb tüdőfunkciós metrikák
Mentális egészség	4	Hangulatállapot-követés és értékelési pontszámok

Megfigyelések — Általános

Csoport	Végpontok	Leírás
Adatminőség	1	Megfigyelési adatfolyamok minőségi metrikái
FIT fájl feltöltés	1	Nyers Garmin FIT fájlok feltöltése feldolgozásra
Garmin alvás	1	Közvetlen Garmin Sleep API adatbevitel
Garmin hiányok	1	Garmin adatfolyamok hiányainak azonosítása

Kérdőívek

Csoport	Végpontok	Leírás
Kérdőívek	4	Kérdőívek listázása, részletek lekérése, elemek fordításokkal (Accept-Language) és válaszok lekérdezése.

Riasztások

Csoport	Végpontok	Leírás
Észlelt problémák	7	Riasztások osztályozása, törlése vagy tévesen bevittként jelölése. Osztályozási részletek frissítése. Aktivált riasztások lekérdezése.

Időpontok

Csoport	Végpontok	Leírás
Időpontok	6	Teljes ütemezési életciklus — foglalás, bejelentkezés, teljesítés, lemondás, meg nem jelenés, hibás jelölés.

Eszközintegrációk

Csoport	Végpontok	Leírás
Fitbit	4	Fitbit fiókok összekapcsolása/szétkapcsolása, kapcsolat állapotának ellenőrzése, utolsó szinkronizálási idő lekérdezése.
Garmin	1	Közvetlen Garmin adatbeviteli végpontok.

Tartalom

Csoport	Végpontok	Leírás
Könyvtár	1	Oktatási és tájékoztató tartalom-erőforrások listázása.

---

Alap URL

https://api.vitalera.io/api/

Hitelesítés

Minden végpont érvényes JWT Bearer tokent igényel. Lásd a Platform API hitelesítés oldalt.

Gyakori minták

• Lapozás — A lista végpontok lapozott eredményeket adnak vissza count, next és previous mezőkkel.
• Szűrés — A legtöbb lista végpont támogatja a lekérdezési paramétereket állapot, dátum és erőforrás-specifikus mezők szerinti szűréshez.
• Fordítások — A fordítható tartalmú erőforrások támogatják az Accept-Language fejlécet.
• Állapotátmenetek — Az életciklussal rendelkező erőforrások (feladatok, tervek, időpontok, riasztások) dedikált POST /{id}/{action}/ végpontokat használnak.
• Sebességkorlátok — Lásd a Sebességkorlátok és kvóták oldalt.

Teljes hozzáférés

Az interaktív API referencia teljes kérés/válasz sémákkal, paraméter-dokumentációval és sandbox környezettel az ügyfelek számára elérhető. Lépjen velünk kapcsolatba hitelesítő adatokért.