Időpontok
Eredmények elküldése e-mailben
E-mail küldése az ügyfélnek, hogy elkészültek a laboreredményei
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"
}
Küldj az ügyfélnek egy e-mailt arról, hogy a laboreredményei elkészültek. Az e-mail az időpont
profiljának
email címére megy.
Az e-mail általános partnerarculatot használ: a profil elsődleges profilcsoportjának nevét és
logóját. A nyelve a profil language értéke, alapértelmezés szerint angol.
Állítsd a with_reports értékét true-ra az időpont laborleleteinek csatolásához. Az e-mail
minden olyan leletet csatol, amelyet az ügyfél lát az alkalmazásban. Állítsd false-ra,
ha csak az értesítést szeretnéd elküldeni. Add meg a note mezőt, ha személyes megjegyzést is megjelenítenél az e-mailben, legfeljebb 1 000 karakterig.
Minden csatolt lelet AES-256 titkosítású PDF. A jelszó a profil date_of_birth értéke
8 számjegyként, DDMMYYYY formátumban, pontok nélkül: egy 1985. február 1-jén született ügyfél
ezt írja be: 01021985. Az e-mail közli az ügyféllel ezt a formátumot, de magát a születési dátumot soha.
Minden hívás egy e-mailt küld. A hívások nincsenek deduplikálva: ha kétszer hívod meg a végpontot, az ügyfél
két e-mailt kap.
Nem küldünk e-mailt, ha:
- Még nem érkezett laborlelet.
- A profilnak nincs e-mail-címe, vagy csak helyőrző
@aniva.emailcíme van. - A profil kikapcsolta a tranzakciós e-maileket. Az újbóli bekapcsoláshoz állítsd a
transactional_emails_enabledértékéttrue-ra a Profil frissítése végponttal. - A
with_reportsértéketrue, és a profilnak nincsdate_of_birthértéke. Állítsd be a Profil frissítése végponttal, vagy külddwith_reports: falseértékkel.
results_view scope szükséges.
Kérés
Útvonalparaméterek
Annak az időpontnak az egyedi azonosítója (UUID), amelynek az eredményeit e-mailben küldöd el.
Törzsparaméterek
A
true érték jelszóval védett PDF-fájlként csatolja a laborleleteket. A false érték csak azt az értesítést küldi el, hogy az eredmények
elkészültek.Személyes megjegyzés, amelyet az e-mail az értesítés alatt jelenít meg. Legfeljebb 1 000 karakter.
Válasz
Siker esetén az API200 OK választ ad vissza.
Hibaválaszok
A hibatörzs tartalmazza azerror mezőt, amely ember által olvasható üzenet, valamint a reason mezőt, amely stabil kód. Validációs hibáknál
és hiányzó results_view scope esetén nincs reason.
| Státusz | Ok | Leírás |
|---|---|---|
400 | — | Validációs hiba — érvénytelen azonosító, hiányzó with_reports, vagy az 1 000 karakternél hosszabb note. |
403 | access_denied | Tiltott — az API-kulcsodnak nincs meg ez a scope, vagy az időpont a hozzáférési kontextusodon kívül esik. |
404 | not_found | Az időpont nem található. |
409 | no_reports | Még nem érkezett laborlelet. |
409 | no_email | A profilnak nincs e-mail-címe. |
409 | placeholder_email | A profilnak csak helyőrző @aniva.email címe van. Frissítsd a profilt egy valós e-mail-címmel. |
409 | unsubscribed | A profil kikapcsolta a tranzakciós e-maileket. Előbb állítsd a transactional_emails_enabled értékét true-ra. |
409 | no_birthdate | A with_reports értéke true, és a profilnak nincs date_of_birth értéke, amely a PDF jelszava. |
413 | reports_too_large | A leletek túl nagyok egyetlen e-mailhez. Küldd el az e-mailt with_reports: false értékkel. |
422 | report_unprotectable | Egy lelet nem PDF, vagy nem sikerült jelszóval védeni. Küldd el with_reports: false értékkel. |
500 | — | Belső szerverhiba. |
502 | report_unavailable | Egy laborleletet nem sikerült betölteni. Nem küldtünk e-mailt. |
502 | send_failed | Az e-mail-szolgáltató elutasította az e-mailt. Nem küldtünk e-mailt. |
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"
}