Emfit QS Cloud API
Yleiskatsaus

Emfit tarjoaa asiakkaille kaksi pääasiallista tapaa hakea automaattisesti QS-unisensorien keräämää dataa pilvipalvelun kautta:

1. Push API (Unitiivistelmät ja reaaliaikainen data)

• Voimme lähettää käsitellyn datan automaattisesti järjestelmääsi heti, kun se on saatavilla – jatkuvaa kyselyä ei tarvita.

• Unitiivistelmädata: Toimitetaan, kun käyttäjä nousee sängystä ja koko unijakso on käsitelty (noin 5–20 minuutin viive).

• Reaaliaikainen data (valinnainen) ja tapahtumat: Syke, hengitystaajuus ja liikedata joka 30. sekunti; tapahtumat (esimerkiksi sänkyyn paluu, sängystä poistuminen, levottomuus, ei kääntymistä) heti tapahtuman jälkeen.

• Status API: Päivittää 30 sekunnin välein viimeisimmän tunnetun tilan ja sen aikaleiman.

• Muoto: JSON

Toimitustapa:

• HTTP POST -pyyntö järjestelmäsi päätepisteeseen (sinun tarvitsee vain toimittaa URL-osoite)

• Tai vaihtoehtoisesti toimitus AWS S3:een, Azure Blob Storageen tai SFTP-tallennukseen

• Turvallisuus: Sisältää token-pohjaisen todennuksen, IP-osoitteiden sallintalistan ja valinnaisen OAuthin.

2. Raakadatasignaalitiedostojen API (.CSV ja .EDF)

Edistyneeseen käyttöön (esimerkiksi signaalinkäsittelyyn, tutkimukseen) tarjoamme raakadataa sisältäviä sensoritiedostoja.

Tiedostot sisältävät:

• .CSV: Esikäsitellyt taajuuskaistat (esimerkiksi syke 6–16 Hz, hengitystaajuus 0.1–3 Hz)

• .EDF: Suodattamaton raakadata (esimerkiksi 1–35 Hz, 0.1–3 Hz)

• Koko: Tyypillisesti 15–25 MB per tiedosto

Noutotapa:

• Emfit lähettää järjestelmällesi ilmoituksen tiedoston metatiedoista (jakso, linkki)

• Järjestelmäsi käyttää suojattua API-kutsua tiedostojen lataamiseen

• Turvallisuus: Kumppaniavaimeen perustuva otsikkotodennus

3. Suora pilvitallennusvaihtoehto (suositeltava automaatioon)

Sen sijaan, että dataa vedettäisiin tai työnnettäisiin HTTP-päätepisteisiin, voimme kirjoittaa tiedostot suoraan seuraaviin tallennusratkaisuihin:

1. AWS S3

2. Azure Blob Storage

3. SFTP-palvelin

Tämä menetelmä tukee:

1. Unitiivistelmiä (.json)

2. Raakadatasignaalitiedostoja (.csv, .edf)

3. Valinnaista pakkausta (.gz) ja AES256-salausta