원시 API 스냅샷

Android · 아카이브급 내보내기

Raw API Snapshot은 마이그레이션 및 아카이브 워크플로를 위한 Health.md for Android의 별도 내보내기 제품입니다. 선택한 범위마다 네이티브 레코드를 보존하는 변경 불가능하고 버전 관리되는 JSON 또는 NDJSON 아티팩트 하나를 생성합니다.

Google Play에서 다운로드 Android 앱 가이드

원시 스냅샷이란

호환성 내보내기는 Health Connect 레코드를 읽기 쉬운 일일 HealthData 요약으로 변환합니다. 원시 스냅샷은 이 변환을 완전히 건너뜁니다:

Health Connect 스냅샷은 고정된 AndroidX API가 노출하는 모든 필드를 보존합니다. 네이티브 식별자와 메타데이터, 나노초 타임스탬프, null 허용 소스 오프셋, 원시 열거형 값, 중첩 샘플, 단계, 경로, 계획된 운동 구조까지 포함합니다.
Fitbit, Oura, WHOOP, Withings 스냅샷은 성공한 공급자 응답의 정확한 바이트를 보존하고 엔드포인트 페이지네이션과 서버 측 집계를 공개합니다. 지원되지 않는 공급자는 정규화되거나 Health Connect 데이터로 조용히 대체되지 않고 보고됩니다.
모든 아티팩트는 유형별 상태, 문제, 개수, 체크섬을 담은 매니페스트로 끝납니다. 폴더 내보내기에는 추가로 .sha256 사이드카 파일이 제공됩니다.

원시 스냅샷은 앱이 고정한 공급자 API 기준으로 API 완전하지만, 공급자 데이터베이스의 트랜잭션 백업이 아닙니다. 접근할 수 없는 레코드, API가 노출하지 않는 원래 단위, 삭제된 레코드, 설치된 SDK에 알려지지 않은 필드는 복구할 수 없습니다.

대상 설정 전 미리보기

원시 스냅샷은 대상을 구성하지 않고도 미리 볼 수 있습니다. 미리보기는 공급자 네이티브 읽기 전체를 백업 없는 비공개 저장소에서 수행하고, 메모리에는 제한된 머리·꼬리 텍스트만 유지하며, 임시 아티팩트를 아무것도 업로드하지 않고 삭제합니다.

전달 규칙

원시 API 업로드는 호환성 API 내보내기보다 의도적으로 더 엄격합니다:

규칙	이유
HTTPS 전용	스트리밍되는 아티팩트가 평문으로 전송되지 않음
리디렉션 거부	아티팩트와 자격 증명이 다른 오리진으로 재생될 수 없음
스키마·내보내기·체크섬 헤더	수신 엔드포인트가 수락한 내용을 검증할 수 있음
시도 후 임시 비공개 아티팩트 삭제	기기에 사본이 남지 않음

증분 아카이브

별도로 버전 관리되는 healthmd.raw-changes 백엔드는 Health Connect 변경 토큰과 삭제 표시(톰스톤)를 사용하여 향후 증분 아카이브 워크플로를 지원하므로, 전체 스냅샷이 유일한 아카이브 전략일 필요가 없습니다.

요구 사항

Raw API Snapshot 제품이 포함된 Health.md for Android.
선택한 레코드 유형의 Health Connect 권한, 또는 공급자 스냅샷을 위한 연결된 Fitbit, Oura, WHOOP, Withings 계정.
스냅샷을 업로드하는 경우 HTTPS 엔드포인트. 로컬 폴더 내보내기에는 전송 요구 사항이 없습니다.