Programări
Trimite rezultatele prin e-mail
Anunță clientul prin e-mail că rezultatele sale de laborator sunt gata
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"
}
Trimite clientului un e-mail care îl anunță că rezultatele de laborator sunt gata. E-mailul ajunge la
adresa
email a profilului programării.
E-mailul folosește brandingul generic al partenerului: numele și logo-ul grupului principal
de profiluri al profilului. Este în limba language a profilului, implicit engleză.
Setează with_reports la true pentru a atașa rapoartele de laborator ale programării. E-mailul
atașează fiecare raport pe care clientul îl poate vedea în aplicație. Setează-l la false
pentru a trimite doar notificarea. Adaugă note pentru a afișa o notă personală în e-mail, de cel mult 1.000 de caractere.
Fiecare raport atașat este un PDF criptat cu AES-256. Parola este date_of_birth din
profil sub formă de 8 cifre, DDMMYYYY, fără puncte: un client născut pe 1 februarie 1985 tastează
01021985. E-mailul îi comunică clientului acest format, dar niciodată data nașterii în sine.
Fiecare apel trimite un e-mail. Apelurile nu sunt deduplicate: dacă apelezi endpointul de două ori, clientul
primește două e-mailuri.
E-mailul nu se trimite când:
- Nu a ajuns încă niciun raport de laborator.
- Profilul nu are adresă de e-mail sau are doar o adresă provizorie
@aniva.email. - Profilul are dezactivate e-mailurile tranzacționale. Pentru a le reactiva, setează
transactional_emails_enabledlatrueprin Actualizează profilul. with_reportsestetrue, iar profilul nu aredate_of_birth. Setează valoarea prin Actualizează profilul sau trimite cuwith_reports: false.
results_view.
Cerere
Parametri de cale
Identificatorul unic (UUID) al programării pentru care trimiți rezultatele prin e-mail.
Parametri de corp
true atașează rapoartele de laborator ca fișiere PDF protejate cu parolă. false trimite doar notificarea că rezultatele sunt
gata.Răspuns
La succes, API-ul returnează200 OK.
Răspunsuri de eroare
Corpul unei erori conțineerror, un mesaj lizibil, și reason, un cod stabil. Erorile de validare
și lipsa permisiunii results_view nu au reason.
| Status | Motiv | Descriere |
|---|---|---|
400 | — | Eroare de validare — ID invalid, with_reports lipsește sau note depășește 1.000 de caractere. |
403 | access_denied | Interzis — cheia ta API nu are permisiunea necesară sau programarea este în afara contextului tău de acces. |
404 | not_found | Programarea nu a fost găsită. |
409 | no_reports | Nu a ajuns încă niciun raport de laborator. |
409 | no_email | Profilul nu are adresă de e-mail. |
409 | placeholder_email | Profilul are doar o adresă provizorie @aniva.email. Actualizează profilul cu o adresă reală de e-mail. |
409 | unsubscribed | Profilul are dezactivate e-mailurile tranzacționale. Setează mai întâi transactional_emails_enabled la true. |
409 | no_birthdate | with_reports este true, iar profilul nu are date_of_birth, parola PDF-ului. |
413 | reports_too_large | Rapoartele sunt prea mari pentru un singur e-mail. Trimite e-mailul cu with_reports: false. |
422 | report_unprotectable | Un raport nu este PDF sau nu a putut fi protejat cu parolă. Trimite cu with_reports: false. |
500 | — | Eroare internă de server. |
502 | report_unavailable | Un raport de laborator nu a putut fi încărcat. Nu s-a trimis niciun e-mail. |
502 | send_failed | Furnizorul de e-mail a refuzat e-mailul. Nu s-a trimis niciun e-mail. |
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"
}