API-eindpunt

API-eindpunt is een exportbestemming waarmee je gegevens van Health.md naar je eigen server, webhook, database, dashboard of automatisering stuurt. De iPhone blijft Apple Health uitlezen. In plaats van bestanden te schrijven, stuurt de app JSON met een POST-verzoek naar het eindpunt dat je configureert.

Let op je privacy.

Deze bestemming stuurt de geselecteerde gezondheidsgegevens bewust naar de URL die je invoert. Gebruik een eindpunt dat je beheert of vertrouwt, kies bij voorkeur HTTPS en beperk de meetwaarden tot wat je dienst werkelijk nodig heeft.

De bestemming instellen

Open Health.md op de iPhone.
Ga naar Exporteren.
Kies bij Exportbestemming de optie API-eindpunt.
Voer een URL in, bijvoorbeeld https://api.example.com/healthmd/ingest.
Optioneel: voer een bearer-token in. Health.md bewaart dit in de sleutelhanger.
Tik op Gereed, kies het datumbereik en de meetwaarden en tik daarna op Exporteren.

Voer je een token zonder voorvoegsel in, dan verstuurt Health.md dit als Authorization: Bearer <token>. Begint de waarde al met Bearer of Basic , dan verstuurt Health.md de waarde ongewijzigd.

Structuur van de payload

Health.md verstuurt één POST-verzoek per exportactie. De hoofdtekst is een afzonderlijk van versies voorziene healthmd.api_export-envelop met dagelijkse records volgens het openbare schema v8 healthmd.health_data. Versie 1 van de API-envelop bevat de dagelijkse records. Versie 2 kan daarnaast provider-sidecars bevatten zonder het schema van de dagelijkse records te wijzigen.

records

Volledige dagelijkse objecten volgens schema v8 die voor het gevraagde bereik zijn behouden. Dit omvat volledig lege records waarvan het querymanifest als bewijs dient.

failed_date_details

Datums die zijn mislukt voordat er een dagelijks document kon worden behouden.

daily_record_schema_version

De versie van het dagelijkse schema in records. Deze versie ontwikkelt zich onafhankelijk van de versie van de API-envelop.

Provider-sidecars

Optionele externe records in v2 met een eigen schema en eigen identiteitsregels wanneer een verbonden provider is ingeschakeld.

Bekijk de volledig vanuit productie gegenereerde API v1-envelop en API v2-envelop met provider-sidecar. Het API- en CLI-contract beschrijft elk veld, elke versiegrens en elke acceptatieregel.

Vereisten voor het eindpunt

Methode

Accepteer POST.

Contenttype

Accepteer application/json.

Geslaagd

Geef een willekeurige 2xx-status terug nadat de payload veilig is geaccepteerd.

Mislukt

Geef 4xx of 5xx terug voor afgewezen verzoeken. Health.md toont waar mogelijk een kort voorbeeld van het antwoord.

Maak het eindpunt voor betrouwbare verwerking idempotent per datum. Iemand kan hetzelfde exportbereik opnieuw uitvoeren na een wijziging van de meetwaarden of nadat een serverfout is opgelost.

Tips

Test met één dag voordat je een lange historische aanvulling uploadt.
Laat Gezondheidsgegevens zonder verlies ingeschakeld als volledigheid van de bron belangrijk is. Verklein het datumbereik voor omvangrijke routes, klinische documenten, ECG's of bijlagen.
Valideer het token op de server voordat je een payload opslaat.
Gebruik records[].date als primaire sleutel per dag.
Geef een beknopte fouttekst terug; Health.md toont slechts een kort voorbeeld.

Problemen oplossen

Probleem	Betekent meestal	Oplossing
API-bestemming is niet gereed	URL is leeg of ongeldig	Open de instellingen voor API-eindpunt opnieuw en voer een geldige HTTP(S)-URL in.
HTTP 401 of 403	Token ontbreekt of is afgewezen	Werk het token of de autorisatieregels op de server bij.
HTTP 404	URL-pad is onjuist	Controleer de route op je server.
HTTP 413	Payload is te groot	Exporteer minder dagen. Gebruik alleen een uitvoer met samenvattingen als de ontvanger geen canonieke bronrecords nodig heeft.
Sommige datums ontbreken	Geen ingeschakelde HealthKit-gegevens voor die datums	Controleer `failed_date_details` en je selectie van meetwaarden.