Ruwe API-snapshots
Android · export op archiefniveau
Raw API Snapshot is een apart exportproduct van Health.md voor Android voor migratie- en archiefworkflows: één onveranderlijk, versiebeheerd JSON- of NDJSON-artefact per gekozen periode, waarin native records bewaard blijven.
Wat een ruwe snapshot is
Section titled “Wat een ruwe snapshot is”Compatibiliteitsexports zetten Health Connect-records om in leesbare dagelijkse HealthData-samenvattingen. Een ruwe snapshot slaat die conversie volledig over:
- Health Connect-snapshots bewaren elk veld dat de vastgezette AndroidX-API aanbiedt, waaronder native identiteit en metadata, nanoseconde-tijdstempels, nullable bron-offsets, ruwe enum-waarden, geneste samples, fasen, routes en geplande workoutstructuren.
- Fitbit-, Oura-, WHOOP- en Withings-snapshots bewaren de exacte bytes van geslaagde providerreacties en leggen endpoint-paginering en serverzijde-aggregatie open. Niet-ondersteunde providers worden gemeld in plaats van genormaliseerd of stilletjes vervangen door Health Connect-gegevens.
- Elk artefact eindigt met een manifest met status, problemen, aantallen en controlesommen per type. Mapexports krijgen bovendien een
.sha256-bestand ernaast.
Een ruwe snapshot is API-compleet voor de vastgezette provider-API van de app, maar geen transactionele back-up van de providerdatabase. Hij kan ontoegankelijke records, originele eenheden die de API niet blootlegt, verwijderde records of velden die onbekend zijn voor de geïnstalleerde SDK niet herstellen.
Voorbeeld voordat je een bestemming kiest
Section titled “Voorbeeld voordat je een bestemming kiest”Ruwe snapshots kun je bekijken zonder ingestelde bestemming. De voorbeeldweergave voert de volledige provider-native leesactie uit naar privé-opslag zonder back-ups, houdt alleen begrensde begin- en eindtekst in het geheugen en verwijdert het tijdelijke artefact zonder iets te uploaden.
Bezorgingsregels
Section titled “Bezorgingsregels”Ruwe API-uploads zijn opzettelijk strenger dan compatibiliteits-API-exports:
| Regel | Reden |
|---|---|
| Alleen HTTPS | Het gestreamde artefact reist nooit als leesbare tekst |
| Omleidingen geweigerd | Het artefact en de inloggegevens kunnen nooit naar een andere origin worden doorgespeeld |
| Schema-, export- en controlesomheaders | Het ontvangende endpoint kan verifiëren wat het heeft geaccepteerd |
| Tijdelijk privé-artefact na de poging verwijderd | Er blijft geen kopie op het apparaat achter |
Incrementele archieven
Section titled “Incrementele archieven”De apart versiebeheerde healthmd.raw-changes-backend gebruikt Health Connect-wijzigingstokens en verwijdermarkers (tombstones) voor toekomstige incrementele archiefworkflows, zodat een volledige snapshot niet de enige archiefstrategie hoeft te zijn.
Vereisten
Section titled “Vereisten”- Health.md voor Android met het Raw API Snapshot-product.
- Health Connect-machtigingen voor de gekozen recordtypen, of een gekoppeld Fitbit-, Oura-, WHOOP- of Withings-account voor providersnapshots.
- Een HTTPS-endpoint als je snapshots uploadt; export naar een lokale map stelt geen transportvereisten.