Записи
Отправить результаты по электронной почте
Отправить клиенту письмо о готовности лабораторных результатов
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"
}
Отправь клиенту одно письмо о том, что лабораторные результаты готовы. Письмо уходит на
email профиля этой записи.
В письме используется общий брендинг партнёра: название и логотип основной группы профилей
этого профиля. Язык письма — language профиля, по умолчанию английский.
Задай для with_reports значение true, чтобы прикрепить лабораторные отчёты по записи. К письму
прикрепляются все отчёты, которые клиент видит в приложении. Задай false,
чтобы отправить только уведомление. Добавь note, чтобы показать в письме личную заметку — не более 1 000 символов.
Каждый прикреплённый отчёт — это PDF-файл, зашифрованный с помощью AES-256. Пароль — поле date_of_birth
профиля в виде 8 цифр, DDMMYYYY, без точек: клиент, родившийся 1 февраля 1985 года, вводит
01021985. В письме клиенту сообщается этот формат, но никогда не указывается сама дата рождения.
Каждый вызов отправляет одно письмо. Вызовы не дедуплицируются: если ты вызовешь эндпоинт дважды, клиент
получит два письма.
Письмо не отправляется, если:
- Ни один лабораторный отчёт ещё не поступил.
- У профиля нет email-адреса или указан только адрес-заглушка
@aniva.email. - В профиле отключены транзакционные письма. Чтобы снова включить их, задай для
transactional_emails_enabledзначениеtrueчерез Обновить профиль. with_reportsимеет значениеtrue, а у профиля не указаноdate_of_birth. Укажи его через Обновить профиль или отправь запрос сwith_reports: false.
results_view.
Запрос
Параметры пути
Уникальный идентификатор (UUID) записи, результаты которой нужно отправить по email.
Параметры тела запроса
true прикрепляет лабораторные отчёты в виде PDF-файлов, защищённых паролем. false отправляет только уведомление о готовности
результатов.Ответ
При успехе API возвращает200 OK.
Количество прикреплённых лабораторных отчётов.
0, если with_reports имеет значение false.Ответы с ошибками
Тело ошибки содержитerror (понятное человеку сообщение) и reason (стабильный код). У ошибок валидации
и при отсутствии права доступа results_view поле reason отсутствует.
| Статус | Причина | Описание |
|---|---|---|
400 | — | Ошибка валидации — некорректный ID, отсутствует with_reports или note длиннее 1 000 символов. |
403 | access_denied | Доступ запрещён — у твоего API-ключа нет нужного права доступа или запись находится вне твоего контекста доступа. |
404 | not_found | Запись не найдена. |
409 | no_reports | Ни один лабораторный отчёт ещё не поступил. |
409 | no_email | У профиля нет email-адреса. |
409 | placeholder_email | У профиля указан только адрес-заглушка @aniva.email. Обнови профиль, указав настоящий email. |
409 | unsubscribed | В профиле отключены транзакционные письма. Сначала задай для transactional_emails_enabled значение true. |
409 | no_birthdate | with_reports имеет значение true, а у профиля нет date_of_birth — пароля для PDF. |
413 | reports_too_large | Отчёты слишком большие для одного письма. Отправь письмо с with_reports: false. |
422 | report_unprotectable | Отчёт не является PDF-файлом или его не удалось защитить паролем. Отправь письмо с with_reports: false. |
500 | — | Внутренняя ошибка сервера. |
502 | report_unavailable | Не удалось загрузить лабораторный отчёт. Письмо не отправлено. |
502 | send_failed | Почтовый провайдер отклонил письмо. Письмо не отправлено. |
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"
}