Rohe API-Snapshots
Android · Export in Archivqualität
Raw API Snapshot ist ein separates Exportprodukt von Health.md für Android für Migrations- und Archivierungsworkflows: ein unveränderliches, versioniertes JSON- oder NDJSON-Artefakt pro ausgewähltem Zeitraum, das native Datensätze bewahrt.
Was ein roher Snapshot ist
Abschnitt betitelt „Was ein roher Snapshot ist“Kompatibilitätsexporte wandeln Health Connect-Datensätze in lesbare tägliche HealthData-Zusammenfassungen um. Ein roher Snapshot überspringt diese Umwandlung vollständig:
- Health Connect-Snapshots bewahren jedes Feld, das die fixierte AndroidX-API bereitstellt, einschließlich nativer Identität und Metadaten, Nanosekunden-Zeitstempel, nullbarer Quelloffsets, roher Enum-Werte, verschachtelter Samples, Stages, Routen und geplanter Workout-Strukturen.
- Fitbit-, Oura-, WHOOP- und Withings-Snapshots bewahren die exakten Bytes erfolgreicher Anbieterantworten und legen Endpunkt-Paginierung sowie serverseitige Aggregation offen. Nicht unterstützte Anbieter werden gemeldet, statt normalisiert oder stillschweigend durch Health Connect-Daten ersetzt zu werden.
- Jedes Artefakt endet mit einem Manifest mit Status, Problemen, Anzahlen und Prüfsummen je Typ. Ordner-Exporte erhalten zusätzlich eine
.sha256-Begleitdatei.
Ein roher Snapshot ist API-vollständig für die fixierte Anbieter-API der App, aber kein transaktionaler Backup der Anbieterdatenbank. Er kann nicht zugängliche Datensätze, Originaleinheiten, die die API nicht offenlegt, gelöschte Datensätze oder Felder, die dem installierten SDK unbekannt sind, nicht wiederherstellen.
Vorschau vor dem Ziel
Abschnitt betitelt „Vorschau vor dem Ziel“Rohe Snapshots können ohne konfiguriertes Ziel in der Vorschau angezeigt werden. Die Vorschau führt die vollständige anbieternative Lesung in privaten No-Backup-Speicher aus, behält nur begrenzten Kopf- und Endtext im Speicher und löscht das temporäre Artefakt, ohne etwas hochzuladen.
Zustellungsregeln
Abschnitt betitelt „Zustellungsregeln“Rohe API-Uploads sind bewusst strenger als Kompatibilitäts-API-Exporte:
| Regel | Grund |
|---|---|
| Nur HTTPS | Das gestreamte Artefakt reist nie im Klartext |
| Weiterleitungen werden abgelehnt | Artefakt und Zugangsdaten können nie an einen anderen Ursprung weitergereicht werden |
| Schema-, Export- und Prüfsummen-Header | Der empfangende Endpunkt kann verifizieren, was er akzeptiert hat |
| Temporäres privates Artefakt wird nach dem Versuch gelöscht | Auf dem Gerät verbleibt keine Kopie |
Inkrementelle Archive
Abschnitt betitelt „Inkrementelle Archive“Das separat versionierte healthmd.raw-changes-Backend nutzt Health Connect-Änderungstoken und Löschmarkierungen (Tombstones) für künftige inkrementelle Archivierungsworkflows, sodass ein vollständiger Snapshot nicht die einzige Archivierungsstrategie sein muss.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- Health.md für Android mit dem Produkt Raw API Snapshot.
- Health Connect-Berechtigungen für die ausgewählten Datensatztypen oder ein verbundenes Fitbit-, Oura-, WHOOP- oder Withings-Konto für Anbieter-Snapshots.
- Ein HTTPS-Endpunkt, wenn Sie Snapshots hochladen; der lokale Ordner-Export hat keine Transportanforderungen.