Bokningar
Mejla resultat
Mejla kunden om att labbresultaten är klara
POST
/
api
/
v1
/
appointments
/
{id}
/
results
/
email
curl --request POST \
--url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/results/email \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"with_reports": true,
"note": "Your vitamin D is low. We will talk about it at your next visit."
}'
{
"recipient_email": "maria.schmidt@example.com",
"attachment_count": 1,
"sent_at": "2026-10-15T09:12:44.512Z"
}
{
"error": "This customer has turned off emails. Turn emails on for them first.",
"reason": "unsubscribed"
}
Skicka ett mejl till kunden som meddelar att labbresultaten är klara. Mejlet skickas till
email på bokningens profil.
Mejlet använder generell partnerprofilering: namnet och logotypen för profilens primära
profilgrupp. Det är på profilens language, engelska som standard.
Sätt with_reports till true för att bifoga bokningens labbrapporter. Mejlet
bifogar alla rapporter som kunden kan se i appen. Sätt den till false
för att bara skicka aviseringen. Lägg till note för att visa ett personligt meddelande i mejlet, högst 1 000 tecken.
Varje bifogad rapport är en PDF krypterad med AES-256. Lösenordet är profilens date_of_birth
som 8 siffror, DDMMYYYY, utan punkter: en kund som är född 1 februari 1985 skriver
01021985. Mejlet talar om det här formatet för kunden, men aldrig själva födelsedatumet.
Varje anrop skickar ett mejl. Anrop dedupliceras inte: om du anropar endpointen två gånger får kunden
två mejl.
Mejlet skickas inte när:
- Ingen labbrapport har kommit in ännu.
- Profilen har ingen e-postadress, eller bara en platshållaradress på
@aniva.email. - Profilen har stängt av transaktionsmejl. För att slå på dem igen sätter du
transactional_emails_enabledtilltruemed Uppdatera profil. with_reportsärtrueoch profilen saknardate_of_birth. Ange det med Uppdatera profil, eller skicka medwith_reports: false.
results_view.
Förfrågan
Sökvägsparametrar
Body-parametrar
true bifogar labbrapporterna som lösenordsskyddade PDF-filer. false skickar bara aviseringen om att resultaten är
klara.Svar
Vid framgång returnerar API:et200 OK.
Felsvar
En fel-body harerror, ett läsbart meddelande, och reason, en stabil kod. Valideringsfel
och ett saknat results_view-scope har inget reason.
| Status | Orsak | Beskrivning |
|---|---|---|
400 | — | Valideringsfel — ogiltigt ID, with_reports saknas eller note är längre än 1 000 tecken. |
403 | access_denied | Åtkomst nekad — din API-nyckel har inte scopet, eller så ligger bokningen utanför din åtkomstkontext. |
404 | not_found | Bokningen hittades inte. |
409 | no_reports | Ingen labbrapport har kommit in ännu. |
409 | no_email | Profilen har ingen e-postadress. |
409 | placeholder_email | Profilen har bara en platshållaradress på @aniva.email. Uppdatera profilen med en riktig e-postadress. |
409 | unsubscribed | Profilen har stängt av transaktionsmejl. Sätt transactional_emails_enabled till true först. |
409 | no_birthdate | with_reports är true och profilen saknar date_of_birth, som är PDF-lösenordet. |
413 | reports_too_large | Rapporterna är för stora för ett mejl. Skicka mejlet med with_reports: false. |
422 | report_unprotectable | En rapport är inte en PDF eller kunde inte lösenordsskyddas. Skicka med with_reports: false. |
500 | — | Internt serverfel. |
502 | report_unavailable | En labbrapport kunde inte läsas in. Inget mejl skickades. |
502 | send_failed | E-postleverantören avvisade mejlet. Inget mejl skickades. |
curl --request POST \
--url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/results/email \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"with_reports": true,
"note": "Your vitamin D is low. We will talk about it at your next visit."
}'
{
"recipient_email": "maria.schmidt@example.com",
"attachment_count": 1,
"sent_at": "2026-10-15T09:12:44.512Z"
}
{
"error": "This customer has turned off emails. Turn emails on for them first.",
"reason": "unsubscribed"
}
⌘I
curl --request POST \
--url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/results/email \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"with_reports": true,
"note": "Your vitamin D is low. We will talk about it at your next visit."
}'
{
"recipient_email": "maria.schmidt@example.com",
"attachment_count": 1,
"sent_at": "2026-10-15T09:12:44.512Z"
}
{
"error": "This customer has turned off emails. Turn emails on for them first.",
"reason": "unsubscribed"
}