Kategoria: Formularze i API

Formularz na stronie nie wysyła wiadomości — co sprawdzić w API?

Poradnik techniczny · Kacper Bernecki

Formularz wygląda poprawnie, ale klient nie otrzymuje potwierdzenia, a zgłoszenie nie trafia do firmy. Najpierw sprawdź, czy żądanie trafia do serwera, czy zapisuje zgłoszenie i czy zwraca prawdziwy wynik wysyłki.

Dlaczego problem występuje?

Błąd może leżeć w walidacji, endpointcie, ENV, dostawcy e-mail lub w samym UI, które wyświetla sukces bez potwierdzenia zapisu.

Diagnostyka i rozwiązanie

1. W DevTools Network sprawdź, czy po kliknięciu wysyłane jest żądanie i jaki kod HTTP wraca.

2. Porównaj walidację przeglądarki z walidacją serwera; nie ufaj tylko required w HTML.

3. Sprawdź runtime logs endpointu, czas wykonania i odpowiedź dostawcy poczty lub CRM.

4. Oddziel sukces zapisu zgłoszenia od sukcesu wysłania wiadomości e-mail i dodaj obsługę ponowień.

5. Uruchom test z fikcyjnymi danymi z telefonu i desktopu; sprawdź też ochronę antyspamową.

Jak sprawdzić i czego unikać?

Zgłoszenie testowe jest zapisane lub dostarczone w docelowym systemie, a użytkownik dostaje komunikat zgodny z rzeczywistym wynikiem.

Toast 'wysłano' przed uzyskaniem odpowiedzi serwera daje fałszywe poczucie sukcesu.