Snapshot API non elaborati
Android · export di livello archivistico
Raw API Snapshot è un prodotto di export separato di Health.md per Android, pensato per flussi di migrazione e archiviazione: un artefatto JSON o NDJSON immutabile e versionato per ciascun intervallo selezionato, che conserva i record nativi.
Che cos’è uno snapshot non elaborato
Sezione intitolata “Che cos’è uno snapshot non elaborato”Gli export di compatibilità convertono i record Health Connect in riepiloghi giornalieri leggibili di HealthData. Uno snapshot non elaborato salta del tutto questa conversione:
- Gli snapshot Health Connect conservano ogni campo esposto dall’API AndroidX bloccata, inclusi identità e metadati nativi, timestamp in nanosecondi, offset sorgente nullable, valori enum non elaborati, campioni annidati, fasi, percorsi e strutture di allenamenti pianificati.
- Gli snapshot Fitbit, Oura, WHOOP e Withings conservano i byte esatti delle risposte riuscite del provider e dichiarano la paginazione dell’endpoint e l’aggregazione lato server. I provider non supportati vengono segnalati invece di essere normalizzati o sostituiti in silenzio con dati Health Connect.
- Ogni artefatto termina con un manifest con stato, problemi, conteggi e checksum per tipo. Anche gli export in cartella ricevono un file aggiuntivo
.sha256.
Uno snapshot non elaborato è completo rispetto all’API provider bloccata dell’app, ma non è un backup transazionale del database del provider. Non può recuperare record inaccessibili, unità originali che l’API non espone, record eliminati o campi sconosciuti all’SDK installato.
Anteprima prima della destinazione
Sezione intitolata “Anteprima prima della destinazione”Gli snapshot non elaborati possono essere visualizzati in anteprima senza una destinazione configurata. L’anteprima esegue la lettura nativa completa del provider in una memoria privata senza backup, mantiene in memoria solo un testo iniziale e finale limitato ed elimina l’artefatto temporaneo senza caricare nulla.
Regole di consegna
Sezione intitolata “Regole di consegna”Gli upload di API non elaborata sono volutamente più severi degli export di API di compatibilità:
| Regola | Motivo |
|---|---|
| Solo HTTPS | L’artefatto in streaming non viaggia mai in chiaro |
| Reindirizzamenti rifiutati | L’artefatto e le credenziali non possono mai essere replicati verso un’altra origine |
| Intestazioni di schema, export e checksum | L’endpoint ricevente può verificare cosa ha accettato |
| Artefatto privato temporaneo eliminato dopo il tentativo | Nessuna copia resta sul dispositivo |
Archivi incrementali
Sezione intitolata “Archivi incrementali”Il backend healthmd.raw-changes, con versionamento separato, usa token di modifica e marcatori di eliminazione di Health Connect per futuri flussi di archiviazione incrementale, così uno snapshot completo non deve essere l’unica strategia di archiviazione.
Requisiti
Sezione intitolata “Requisiti”- Health.md per Android con il prodotto Raw API Snapshot.
- Autorizzazioni Health Connect per i tipi di record selezionati, oppure un account Fitbit, Oura, WHOOP o Withings collegato per gli snapshot dei provider.
- Un endpoint HTTPS se carichi gli snapshot; l’esportazione in cartella locale non ha requisiti di trasporto.