Najczęstsze komunikaty o błędach
Gdy żądanie się nie powiedzie, Bird zwraca ustrukturyzowany błąd z kodem maszynowym, komunikatem, linkiem do dokumentacji i identyfikatorem żądania. Używaj kodu w logice programu. Jeśli potrzebujesz pomocy, wybierz Feedback > Contact us i dołącz identyfikator żądania. Pełny katalog znajdziesz w dokumentacji błędów API.
Błędy walidacji
Oznaczają, że Bird zrozumiał Twoje żądanie, ale coś w nim jest niedopuszczalne. Błąd wskazuje konkretne pole lub warunek, który zawiódł.
Wszyscy odbiorcy zablokowani
Co to oznacza: każdy odbiorca w Twojej wysyłce znajduje się na liście blokad, więc nie było nikogo, do kogo można dostarczyć wiadomość, i wysyłka została odrzucona.
Prawdopodobna przyczyna: wysyłasz na adresy, które wcześniej dały twardy bounce, zgłosiły skargę lub wypisały się. Często oznacza to ponowne wysyłanie do starej lub nieoczyszczonej listy. Jeśli tylko część odbiorców jest zablokowana, wysyłka dochodzi do pozostałych, a zablokowani widnieją jako odrzuceni; ten błąd pojawia się tylko wtedy, gdy dotyczy wszystkich.
Sposób naprawy: sprawdź, które adresy są zablokowane i dlaczego, a następnie usuń je ze swojej listy. Dlaczego mój e-mail został odrzucony? wyjaśnia, jak wyglądają odrzucenia z powodu blokady, a przewodnik po blokadach opisuje zarządzanie listą.
Niedozwolony odbiorca onboardingowy
Co to oznacza: wysyłasz ze współdzielonej domeny onboardingowej Bird do osoby, która nie jest zweryfikowanym członkiem Twojego obszaru roboczego.
Prawdopodobna przyczyna: współdzielona domena dostarcza wiadomości wyłącznie do zweryfikowanych członków obszaru roboczego i adresów testowych sandboxa.
Sposób naprawy: aby wysyłać e-maile do rzeczywistych odbiorców, zweryfikuj własną domenę nadawczą, co całkowicie znosi ograniczenie. Szczegóły znajdziesz w artykule Wysyłanie ze współdzielonej domeny.
Brakujące lub nieprawidłowe pole
Co to oznacza: brakuje wymaganego pola, wartość jest nieprawidłowa lub żądanie łączy niekompatybilne pola.
Prawdopodobna przyczyna: żądanie nie pasuje do schematu operacji lub łączy niekompatybilne pola. Szczegóły błędu wskazują każde pole, które zawiodło.
Sposób naprawy: przeczytaj szczegóły błędu i popraw wskazane pola.
Błędy ograniczania liczby żądań
Co to oznacza: żądanie przekroczyło limit operacji, konta lub wysyłki.
Prawdopodobna przyczyna: seria żądań przekroczyła limit API lub wysyłka przekroczyła limit, np. dzienny limit odbiorców współdzielonej domeny onboardingowej.
Sposób naprawy: postępuj zgodnie ze wskazówkami naprawczymi błędu i wartością Retry-After, jeśli jest podana. Przy przejściowych limitach spróbuj ponownie z rosnącym odstępem. W przypadku dziennego limitu onboardingowego poczekaj na reset dnia UTC lub zweryfikuj własną domenę nadawczą. Etykieta kondycji e-mail throttled ma charakter diagnostyczny i nie powoduje błędu ograniczania liczby żądań API.
Błędy uwierzytelniania
Co to oznacza: Bird nie mógł zaakceptować Twoich danych uwierzytelniających.
Prawdopodobna przyczyna: jedna z trzech rzeczy, w przybliżeniu od najczęstszej:
- Błędny, wygasły lub unieważniony klucz API: klucz jest wpisany z błędem, obcięty, wygasły lub nieaktywny. Sekret jest wyświetlany tylko w momencie tworzenia lub rotacji klucza.
- Klucz użyty w niewłaściwym regionie: klucze API są regionalne i działają tylko na serwerach swojego regionu. Jeśli klucz został utworzony w jednym regionie, a Twój kod wywołuje inny, uwierzytelnianie kończy się niepowodzeniem. Prefiks klucza wskazuje, do którego regionu należy.
- Brak klucza: żądanie w ogóle nie zawierało danych uwierzytelniających. Częstą przyczyną jest zmienna środowiskowa, która jest pusta w środowisku powodującym błąd.
Sposób naprawy: upewnij się, że klucz istnieje i jest aktywny w dashboardzie, że Twój kod go wysyła i że wywołujesz adres regionu odpowiadający kluczowi. W razie wątpliwości utwórz nowy klucz i podmień go.
Domena niezweryfikowana
Co to oznacza: domena nadawcza nie przeszła weryfikacji, więc Bird nie może z niej wysyłać.
Prawdopodobna przyczyna: rekordy DNS nie istnieją, wciąż się propagują lub są nieprawidłowe, albo zmieniły się po weryfikacji. Przewidywany czas znajdziesz w liście kontrolnej weryfikacji domeny.
Sposób naprawy: otwórz stronę domeny w dashboardzie, aby zidentyfikować brakujący rekord. Napraw go, korzystając z listy kontrolnej weryfikacji domeny. Dopóki DNS się propaguje, do wysyłek testowych używaj współdzielonej domeny onboardingowej.
Odczytywanie dowolnego napotkanego błędu
Dopasowuj po maszynowym kodzie błędu, ponieważ komunikaty tekstowe mogą się zmieniać. Loguj identyfikator żądania. Jeśli potrzebujesz pomocy, wybierz Feedback > Contact us i dołącz go. Postępuj zgodnie z linkiem do dokumentacji, aby uzyskać wskazówki naprawcze dla danego błędu.
Następne kroki
- Dokumentacja błędów API (pełny katalog: każdy typ błędu, kod i status)
- Dlaczego mój e-mail został odrzucony?: przyczyny odrzuceń poszczególnych odbiorców
- Dlaczego kondycja e-mail pokazuje Throttled?: diagnostyczna etykieta kondycji i stojące za nią sygnały
- Wysyłanie ze współdzielonej domeny: ograniczenia odbiorców i dziennego limitu domeny onboardingowej
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Obejrzyj przewodnikWhat happens when someone opts outZrozum koncepcjęWhat is one-click unsubscribe, and how do I implement List-Unsubscribe?Poznaj możliwościEmail opt-outsPodążaj ścieżką naukiOperate messaging reliably
Uzyskaj brief wdrożeniowy