MailerLite — jak używać: integracje i automatyzacje

MailerLite API umożliwia aplikacjom wymianę danych z MailerLite. Domyślny i zalecany format danych to application/json¹. W artykule znajdziesz sposób uzyskania dostępu do API, opis zasobów dotyczących subskrybentów, grup i kampanii oraz narzędzia do integracji. Globalny limit MailerLite API wynosi 120 żądań na minutę².

Czym jest dostęp do API MailerLite i jak go skonfigurować?

Dostęp do API MailerLite wymaga tokenu API, który uwierzytelnia żądania wysyłane przez aplikację lub stronę.
Utwórz token i zapisz go poza publicznie dostępnym kodem strony. Następnie dodaj go do konfiguracji aplikacji. Bez prawidłowego tokenu API zwraca odpowiedź HTTP 401 Unauthorized².

MailerLite API przyjmuje także dane w formacie application/x-www-form-urlencoded¹.
Format określa, jak aplikacja zapisuje informacje w żądaniu. Dokumentacja MailerLite Classic wymienia trzy formaty żądań POST i PUT: application/json, multipart/form-data oraz application/x-www-form-urlencoded¹.

Jak połączyć aplikację lub stronę z API MailerLite?

Połączenie aplikacji lub strony z MailerLite API zacznij od utworzenia tokenu w panelu. Potem przekaż go do konfiguracji aplikacji.
Token pozwala API uwierzytelnić nadawcę żądania.

• Sekcja Integrations znajduje się w menu po lewej stronie panelu MailerLite; przejdź do niej, aby znaleźć token API³.
• Konfiguracja tokenu API pozwala nadać mu nazwę „Website” i wybrać opcję „All IPs are allowed”³.
• Aplikacja lub strona powinna przechowywać token poza publicznie dostępnym kodem i dołączać go do żądań wysyłanych do API.

Po skonfigurowaniu tokenu wyślij żądanie z aplikacji. W ten sposób sprawdzisz, czy połączenie działa.
Udane żądanie testowe GET, które pobiera subskrybentów, powinno zwrócić kod HTTP 200 OK².

Jak rozpoznać błędy API MailerLite i obsługiwać limity zapytań?

Błędy MailerLite API rozpoznasz po odpowiedzi na żądanie.
Błędy danych i uwierzytelniania wymagają innej reakcji niż zbyt częste wysyłanie zapytań. Przekroczenie limitu żądań do API sygnalizuje kod HTTP 429².

• Status odpowiedzi pokazuje, czy żądanie się powiodło; zapisuj go razem z treścią odpowiedzi.
• Błąd danych lub uwierzytelniania wymaga poprawienia żądania albo konfiguracji tokenu przed ponowną próbą².
• Limit zapytań wymaga zmniejszenia tempa wysyłania i ponowienia żądania zgodnie z informacją zwróconą przez API.

Obsługa błędów powinna oddzielać żądania wymagające poprawy od tych, które można ponowić później².

Jak sprawdzić, czy żądanie do API MailerLite działa poprawnie?

Żądanie do MailerLite API uznaj za skuteczne, gdy odpowiedź potwierdza wykonanie zamierzonej operacji.
Samo wysłanie żądania nie mówi jeszcze, jaki był wynik².

• Żądanie testowe wyślij z aplikacji, w której skonfigurowano token.
• Status i treść odpowiedzi porównaj z oczekiwanym wynikiem operacji; sam status nie wystarczy do oceny.
• Wynik w aplikacji sprawdź, aby upewnić się, że odpowiedź API przekłada się na zamierzone działanie integracji⁴.

Weryfikacja żądania obejmuje zarówno odpowiedź API, jak i efekt w połączonej aplikacji.
Sprawdź oba te sygnały. Kod HTTP 422 wskazuje błąd walidacji danych przesłanych w żądaniu⁵.

Czym są zasoby API MailerLite: subskrybenci, grupy i kampanie?

Subskrybenci, grupy i kampanie to zasoby MailerLite API, na których aplikacja wykonuje operacje.
Subskrybent jest kontaktem na liście mailingowej. Grupa porządkuje kontakty, a kampania dotyczy wysyłki wiadomości. O rodzaju operacji decyduje metoda HTTP użyta w żądaniu. Jedna strona wyników pobierania subskrybentów należących do grupy może zawierać maksymalnie 1000 kontaktów⁶.

Tabela zestawia 4 metody HTTP MailerLite API i przypisane im operacje.

Dane w tabeli: 1

Metoda HTTP wskazuje, czy aplikacja pobiera informacje o zasobie, dodaje je, zmienia czy usuwa.
Przy usuwaniu subskrybenta używa metody DELETE. Powodzenie tej operacji potwierdza kod HTTP 204 No Content⁵.

Narzędzia do pracy z API i dostępność integracji MailerLite

MailerLite API można obsługiwać przez bibliotekę SDK, klienta API albo narzędzie automatyzacji. Dostępność usługi oceniaj osobno od działania własnego połączenia.
SDK ułatwia wywoływanie API w kodzie aplikacji, a klient API służy do przygotowywania i wysyłania żądań. Wśród nazw związanych z integracją są MailerLite API Node i n8n. MailerLite wymienia oficjalne biblioteki SDK dla pięciu języków: PHP, Go, JavaScript (Node.js), Python i Ruby².

Jakie biblioteki SDK i klienty API są dostępne dla MailerLite?

MailerLite SDKs and API Clients obejmują narzędzia do wywoływania API z kodu oraz do ręcznej pracy z żądaniami.
SDK przydaje się przy rozwijaniu aplikacji, a klient API pozwala obejrzeć odpowiedź na przygotowane żądanie.

Tabela porównuje zastosowanie SDK, klienta API i platformy n8n.

Dane w tabeli: 7

Jak sprawdzić, czy API MailerLite i integracje są niedostępne?

Dostępność MailerLite API i integracji ocenisz, porównując status usługi z odpowiedzią na żądanie wysłane z własnej aplikacji.
Tak rozróżnisz zgłoszony problem usługi od błędu połączenia. Sama informacja o awarii nie pokazuje jeszcze, czy dotyczy Twojej integracji.

• StatusGator śledzi zgłoszone awarie, problemy z wydajnością i prace konserwacyjne dotyczące MailerLite API & integrations⁸.
• Historia zdarzeń pozwala sprawdzić zakres i czas zgłoszonych prac; zdarzenie „Database Maintenance – MailerLite” trwało 30 min^8,9.
• Odpowiedź na żądanie z własnej aplikacji pozwala ustalić, czy problem występuje także w używanej integracji.

Status usługi i wynik własnego żądania to dwa odrębne sygnały przy diagnozowaniu połączenia.

Najczęściej zadawane pytania

Czy MailerLite API przyjmuje wyłącznie dane w formacie JSON?

Nie. API przyjmuje też dane w formacie application/x-www-form-urlencoded, a dokumentacja MailerLite Classic wymienia również multipart/form-data dla żądań POST i PUT.

Ile subskrybentów może zawierać jedna strona wyników dla grupy?

Maksymalnie 1000 kontaktów. To limit pojedynczej strony wyników, a nie liczby kontaktów w grupie.

Co oznacza kod HTTP 422 w odpowiedzi API MailerLite?

Oznacza błąd walidacji danych przesłanych w żądaniu.

Co potwierdza kod HTTP 204 po usunięciu subskrybenta?

Potwierdza powodzenie operacji usunięcia; odpowiedź 204 oznacza „No Content”.