Zamówienia domowych zestawów testowych
Wyślij wyniki e-mailem
Powiadom klienta e-mailem, że wyniki laboratoryjne z jego domowego zestawu testowego są gotowe
POST
/
api
/
v1
/
home-kit-orders
/
{id}
/
results
/
email
curl --request POST \
--url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results/email \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"with_reports": true
}'
{
"recipient_email": "maria.schmidt@example.com",
"attachment_count": 1,
"sent_at": "2026-10-15T09:12:44.512Z"
}
{
"error": "No lab report has arrived yet.",
"reason": "no_reports"
}
Wyślij klientowi jednego e-maila z informacją, że wyniki laboratoryjne są gotowe. Wiadomość trafia na
email z profilu zamówienia domowego zestawu testowego.
E-mail korzysta z ogólnego brandingu partnera: nazwy i logo głównej grupy profili
tego profilu. Jest w języku language profilu, domyślnie po angielsku.
Ustaw with_reports na true, aby załączyć raporty laboratoryjne zestawu. W e-mailu
załączony jest każdy raport, który klient widzi w aplikacji. Ustaw false, aby
wysłać tylko powiadomienie. Dodaj note, aby wyświetlić w e-mailu osobistą notatkę, maksymalnie 1 000 znaków.
Każdy załączony raport to plik PDF zaszyfrowany algorytmem AES-256. Hasłem jest pole date_of_birth
profilu jako 8 cyfr, DDMMYYYY, bez kropek: klient urodzony 1 lutego 1985 wpisuje
01021985. E-mail podaje klientowi ten format, ale nigdy samej daty urodzenia.
Każde wywołanie wysyła jeden e-mail. Wywołania nie są deduplikowane: jeśli wywołasz endpoint dwa razy, klient
dostanie dwa e-maile.
E-mail nie jest wysyłany, gdy:
- Żaden raport laboratoryjny jeszcze nie dotarł.
- Profil nie ma adresu e-mail lub ma tylko zastępczy adres
@aniva.email. - W profilu wyłączono e-maile transakcyjne. Aby włączyć je ponownie, ustaw
transactional_emails_enablednatrueza pomocą Zaktualizuj profil. with_reportsma wartośćtrue, a profil nie ma poladate_of_birth. Ustaw je za pomocą Zaktualizuj profil lub wyślij zwith_reports: false.- Zamówienie jest jednym z demonstracyjnych zamówień domowego zestawu testowego. Zamówienie demonstracyjne nie ma klienta, do którego można wysłać e-mail.
results_view oraz zakresu home_kit_orders_view lub home_kit_orders_manage.
Żądanie
Parametry ścieżki
Unikalny identyfikator (UUID) zamówienia domowego zestawu testowego, którego wyniki chcesz wysłać e-mailem.
Parametry treści
true dołącza raporty laboratoryjne jako pliki PDF chronione hasłem. false wysyła tylko powiadomienie, że wyniki są
gotowe.Odpowiedź
W razie powodzenia API zwraca200 OK.
Odpowiedzi z błędami
Treść błędu zawiera poleerror z czytelnym komunikatem oraz reason ze stałym kodem. Błędy walidacji
i brak zakresu results_view nie mają pola reason.
| Status | Powód | Opis |
|---|---|---|
400 | — | Błąd walidacji — nieprawidłowe ID, brak with_reports lub note dłuższe niż 1 000 znaków. |
403 | access_denied | Brak dostępu — twój klucz API nie ma wymaganych zakresów lub zamówienie domowego zestawu testowego jest poza twoim kontekstem dostępu. |
404 | not_found | Nie znaleziono zamówienia domowego zestawu testowego. |
409 | demo_order | Zamówienie jest demonstracyjnym zamówieniem domowego zestawu testowego. Nie ma klienta, do którego można wysłać e-mail. |
409 | no_reports | Żaden raport laboratoryjny jeszcze nie dotarł. |
409 | no_email | Profil nie ma adresu e-mail. |
409 | placeholder_email | Profil ma tylko zastępczy adres @aniva.email. Zaktualizuj profil, podając prawdziwy adres e-mail. |
409 | unsubscribed | W profilu wyłączono e-maile transakcyjne. Najpierw ustaw transactional_emails_enabled na true. |
409 | no_birthdate | with_reports ma wartość true, a profil nie ma pola date_of_birth, które służy jako hasło do PDF. |
413 | reports_too_large | Raporty są za duże na jeden e-mail. Wyślij e-mail z with_reports: false. |
422 | report_unprotectable | Raport nie jest plikiem PDF lub nie udało się zabezpieczyć go hasłem. Wyślij z with_reports: false. |
500 | — | Wewnętrzny błąd serwera. |
502 | report_unavailable | Nie udało się wczytać raportu laboratoryjnego. Nie wysłano żadnego e-maila. |
502 | send_failed | Dostawca poczty odrzucił wiadomość. Nie wysłano żadnego e-maila. |
curl --request POST \
--url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results/email \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"with_reports": true
}'
{
"recipient_email": "maria.schmidt@example.com",
"attachment_count": 1,
"sent_at": "2026-10-15T09:12:44.512Z"
}
{
"error": "No lab report has arrived yet.",
"reason": "no_reports"
}
⌘I
curl --request POST \
--url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/results/email \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"with_reports": true
}'
{
"recipient_email": "maria.schmidt@example.com",
"attachment_count": 1,
"sent_at": "2026-10-15T09:12:44.512Z"
}
{
"error": "No lab report has arrived yet.",
"reason": "no_reports"
}