Sincronizare date Apple Health cu REST API

Automatizările REST API vă permit să exportați automat datele de sănătate către orice serviciu web care acceptă cereri HTTP POST. Este potrivit pentru integrarea cu backend-uri personalizate, API-uri terțe sau webhook-uri.

Prezentare generală

Automatizările REST API trimit datele de sănătate către un URL specificat folosind cereri HTTP POST. Automatizarea poate trimite date în format JSON sau CSV, cu antete HTTP configurabile pentru autentificare și metadate personalizate.

Cazuri de utilizare:

• Integrare cu servicii backend personalizate
• Trimitere de date către webhook-uri
• Sincronizare cu API-uri terțe
• Construirea de tablouri de bord sau platforme de analiză personalizate

Caracteristici principale:

• Suportă atât formate JSON, cât și CSV
• Antete HTTP personalizate pentru autentificare
• Timeout configurabil pentru cereri
• Export manual al datelor istorice

Limitări

• Acces la date de sănătate: aplicațiile nu au voie să acceseze datele de sănătate cât timp iPhone-ul este blocat. Automatizările rulează doar în perioadele în care dispozitivul este deblocat. Acest lucru poate afecta prospețimea datelor. Consultați instrucțiunile pentru sincronizare manuală pentru a menține datele la zi.

• Procesare în fundal: iOS limitează procesarea în fundal pentru a prelungi durata de viață a bateriei. Automatizările se bazează pe Reîmprospătare aplicație în fundal și s-ar putea să nu ruleze imediat dacă:

  • Reîmprospătarea în fundal este dezactivată pentru aplicație
  • Dispozitivul este în modul de economisire a energiei
  • Dispozitivul a fost inactiv perioade îndelungate
  • Resursele sistemului sunt limitate
  • Mai multe aplicații concurează pentru timp de execuție în fundal

Cerințe preliminare

• Un endpoint URL valid care acceptă cereri HTTP POST
• Date de autentificare (dacă sunt necesare pentru endpoint)
• Conectivitate la rețea pentru a ajunge la endpoint

Configurare

Deschideți ecranul Exporturi automate din navigarea principală, apoi atingeți „Automatizare nouă” și selectați „REST API” ca tip de automatizare.

Nume automatizare

Introduceți un nume descriptiv pentru automatizare (ex.: „API backend propriu”, „Integrare webhook”).

Notificări

Configurați când doriți să primiți notificări:

• Notificare la actualizarea cache-ului — primiți o notificare când datele din cache se actualizează
• Notificare la rulare — primiți o notificare la fiecare execuție a automatizării

Configurare URL

Introduceți URL-ul complet unde doriți să trimiteți datele de sănătate. Trebuie să fie un URL complet, inclusiv protocolul (http:// sau https://).

Exemple de URL-uri:

• https://api.example.com/health-data
• https://webhook.site/your-unique-id
• http://localhost:3000/api/health

Notă: URL-ul trebuie să fie valid și accesibil de pe dispozitiv. URL-urile invalide împiedică rularea automatizării.

Timeout cerere

Selectați un interval de timeout pentru cererile HTTP. Acesta determină cât timp așteaptă aplicația un răspuns înainte de a considera că cererea a eșuat.

Antete HTTP

Adăugați antete HTTP personalizate pentru autentificare sau metadate. Cazuri frecvente de utilizare:

• chei API: X-API-Key: your-api-key
• tokenuri de autorizare: Authorization: Bearer your-token
• suprascrieri ale tipului de conținut: Content-Type: application/json

Pentru a adăuga antete:

1. Atingeți „Adăugați antete”
2. Introduceți cheia antetului în câmpul din stânga
3. Introduceți valoarea antetului în câmpul din dreapta
4. Repetați pentru antete suplimentare

Important: Fiecare cheie de antet trebuie să aibă o valoare corespunzătoare. Antetele goale vor fi ignorate.

Setări tip de date

Tip de date

Selectați ce tip de date de sănătate exportați:

• Metrici de sănătate — pași, puls, somn și alte măsurători de sănătate
• Antrenamente — activități de exercițiu și fitness
• Simptome — simptome și afecțiuni de sănătate
• ECG — înregistrări electrocardiografice
• Notificări privind pulsul — evenimente de puls ridicat sau scăzut
• Stare de spirit — intrări legate de dispoziție și stare mentală (iOS 18.0+)
• Monitorizarea ciclului — date despre ciclul menstrual și sănătatea reproductivă
• Medicamente — jurnale de medicamente și aderență (iOS 26.0+)

Configurare metrici de sănătate

Când este selectat Metrici de sănătate:

Selectare metrici de sănătate — alegeți ce metrici specifice includeți. Puteți selecta toate metricile disponibile sau doar anumite.

Sfat: Selectarea doar a metricilor de care aveți nevoie poate îmbunătăți timpul de procesare și reduce dimensiunea datelor.

Surse preferate — configurați ce surse de date au prioritate când mai multe surse oferă aceeași metrică.

Configurare antrenamente

Când sunt selectate Antrenamente:

Includeți date de traseu — activați pentru a include traseele antrenamentelor care au date de locație.

Includeți metrici din antrenament — activați pentru a include metrici de sănătate colectate în timpul antrenamentelor (puls, calorii etc.).

Grupare temporală (metrici antrenament) — când folosiți versiunea de export 2 și Includeți metrici din antrenament este activat:

• Minute — grupează metricile antrenamentului pe minut
• Secunde — grupează metricile antrenamentului pe secundă

Setări export

Format export

Selectați formatul pentru datele exportate:

• Format JSON — oferă structuri de date detaliate cu obiecte imbricate. Cel mai potrivit pentru API-uri, baze de date și aplicații care au nevoie de date structurate. Formatul JSON include informații mai detaliate pentru tipuri de date complexe, cum ar fi fazele de somn și citirile AFib.

• Format CSV — oferă date tabulare care pot fi importate ușor în aplicații de foi de calcul. Cel mai potrivit pentru analize simple de date sau când endpoint-ul așteaptă date CSV.

Notă: Antetul Content-Type este setat automat la application/json pentru exporturile JSON și la multipart/form-data pentru exporturile CSV.

Versiune export

Selectați o versiune de export. Versionarea permite trecerea la versiuni actualizate ale exportului în propriul ritm și reduce modificările care pot întrerupe fluxurile de lucru.

• Versiunea 1 — format moștenit; folosiți dacă aveți fluxuri existente care depind de acest format
• Versiunea 2 — format actual, cu date de antrenament îmbunătățite și opțiuni de metadate mai detaliate

Interval de date

Selectați când trebuie exportate datele:

• Implicit — sincronizează datele pentru întreaga zi anterioară, plus date până la data și ora curente
• De la ultima sincronizare — la fiecare sincronizare, exportă toate datele de la ultima rulare a exportului până la data și ora curente
• Astăzi — sincronizează toate datele pentru ziua curentă până la momentul curent
• Ieri — sincronizează toate datele pentru întreaga zi anterioară
• Ultimele 7 zile — sincronizează datele pentru întregul interval de șapte zile anterioare

Rezumat date

Când folosiți formatul JSON cu tipul de date Metrici de sănătate, activați sau dezactivați Rezumat date.

• Activat — oferă rezumate agregate ale datelor
• Dezactivat — oferă date dezagregate pe cât posibil, cu puncte individuale de date

Notă: Această setare se aplică doar formatului JSON cu Metrici de sănătate. Datele sunt întotdeauna agregate când folosiți formatul CSV sau când sunt selectate mai multe metrici.

Grupare temporală

Când folosiți formatul JSON cu Rezumat date activat, selectați modul în care trebuie agregate datele.

Notă: Formatul CSV agregă întotdeauna datele. Agregarea la nivel de minut sau secundă poate crește semnificativ timpul de procesare și dimensiunea datelor.

Cereri în lot

Când folosiți formatul JSON, activați Cereri în lot pentru a trimite date în loturi, prin mai multe cereri, în locul unui singur payload.

• Activat — împarte datele pe mai multe cereri pentru a evita payload-uri excesiv de mari
• Dezactivat — trimite toate datele într-o singură cerere

Ritm de sincronizare

Configurați cât de des ar trebui să încarce datele automatizarea:

Selectați un număr și un interval.

Testare și verificare

Testare manuală

1. Atingeți „Export manual” în ecranul de configurare a automatizării
2. Selectați un interval de date
3. Atingeți „Export” pentru a trimite o cerere de test
4. Verificați pe endpoint că datele au fost primite

Vizualizare jurnale de activitate

1. Atingeți „Vizualizați jurnalele de activitate” în ecranul de configurare a automatizării
2. Examinați rulările recente ale automatizării
3. Verificați dacă există erori sau avertismente
4. Verificați marcajele temporale ale cererilor și starea răspunsurilor

Verificare format date

Aplicația include automat următoarele antete în fiecare cerere:

• Content-Type — setat în funcție de formatul de export
• automation-name — numele automatizării dvs.
• automation-id — identificator unic pentru automatizare
• automation-aggregation — gruparea temporală selectată
• automation-period — intervalul de date selectat
• session-id — identificator unic pentru fiecare cerere

Depanare

Probleme frecvente

Datele nu sunt primite la endpoint

• Verificați că URL-ul endpoint-ului este corect
• Confirmați că endpoint-ul acceptă cereri POST
• Revizuiți antetele de autentificare
• Verificați jurnalele endpoint-ului pentru cereri primite
• Verificați conectivitatea la rețea

Sfaturi și bune practici

1. Sincronizare automată:

   • Încărcați dispozitivul și folosiți iPhone Mirroring
     • Când dispozitivul se încarcă, iOS aplică mai puține restricții asupra performanței, astfel că datele se pot sincroniza mai frecvent
     • Folosind iPhone Mirroring, dispozitivul se comportă la fel ca atunci când ar fi deblocat. Astfel, datele de sănătate sunt accesibile pentru Health Auto Export, pentru a rula acțiuni automate

2. Performanță:

   • Folosiți o grupare temporală potrivită pentru a echilibra detaliul față de dimensiunea datelor
   • Selectați doar metricile de care aveți nevoie

3. Fiabilitate:

   • Setați valori de timeout potrivite în funcție de timpul de răspuns al endpoint-ului
   • Monitorizați regulat jurnalele de activitate

4. Format date:

   • Folosiți JSON pentru date structurate și API-uri
   • Folosiți CSV pentru analize simple de date sau integrare cu foi de calcul
   • Luați în calcul cereri în lot pentru seturi mari de date sau procesare separată