Amazfit / Zepp Integration
Reverse-engineered API
Huami (the manufacturer of Amazfit and Zepp-branded smartwatches) does not publish a developer API. The vitalera integration targets the same Huami backend that the Zepp app talks to. Endpoints may change without notice.
Amazfit GTR, GTS, T-Rex, and Zepp-branded watches are some of the lowest-cost full-featured smartwatches on the market — widely used in emerging markets and for employee wellness pilots.
Data types
| Measurement | Encoding | LOINC |
|---|---|---|
| Heart rate | Base64-packed minute arrays | 8867-4 |
| Steps | Daily + minute-level | 55423-8 |
| Sleep | Stages + duration | 93832-4 |
| SpO2 | Spot readings + sleep min | 59408-5 |
| Stress | Huami proprietary score | custom |
| Activity | Workouts + active minutes | — |
| Calories | Total + active | — |
| Distance | Meters | — |
vitalera unpacks the base64-encoded minute arrays and exposes per-minute time series as regular FHIR Observations.
Regional hosts
Huami has separate API hosts by region:
| Region | Host |
|---|---|
| Global | api-mifit.huami.com |
| China | api-mifit-cn.huami.com |
| Europe | api-mifit-de.huami.com |
The region is detected during login.
Connection
curl -X POST https://api.vitalera.io/api/connected-accounts/amazfit/oauth/initiate/ \
-H "Authorization: Bearer <user_token>" \
-d '{"email": "user@example.com", "password": "••••••"}'
Credentials are exchanged for a Huami apptoken; the original password is not stored.