IMAP API

IMAP API to interfejs programistyczny umożliwiający aplikacjom komunikację z serwerem pocztowym za pomocą tego protokołu.

IMAP API jako warstwa komunikacji z pocztą

IMAP API oznacza interfejs programistyczny, przez który aplikacja komunikuje się z serwerem pocztowym zgodnie z protokołem IMAP. Samo określenie „API” nie oznacza jednej, uniwersalnej biblioteki ani konkretnej usługi dostawcy poczty. W praktyce może odnosić się do biblioteki używanej w programie, modułu klienta pocztowego albo własnej warstwy aplikacyjnej, która tłumaczy operacje programu na komendy IMAP. Podstawą komunikacji jest tekstowy protokół klient–serwer, a nie typowe żądania HTTP charakterystyczne dla wielu interfejsów REST.

IMAP został zaprojektowany tak, aby wiadomości pozostawały na serwerze i mogły być odczytywane z wielu urządzeń. Klient pobiera z serwera informacje o folderach, nagłówkach i treści wiadomości, a także może zmieniać stan wiadomości, na przykład oznaczać ją jako przeczytaną, przenosić do innego folderu albo usuwać. Opis klasycznej wersji IMAP4rev1 znajduje się w RFC 3501, natomiast nowsza specyfikacja IMAP4rev2 została opisana w RFC 9051. Konkretne możliwości zależą od wersji obsługiwanej przez serwer oraz od jego rozszerzeń.

Sesja, uwierzytelnianie i wybór skrzynki

Typowa sesja IMAP API rozpoczyna się od nawiązania połączenia z serwerem pocztowym. Po połączeniu serwer wysyła informację powitalną, a klient może użyć komendy CAPABILITY, aby sprawdzić obsługiwane możliwości. Następnie wykonywane jest uwierzytelnianie. W starszym i podstawowym modelu służy do tego komenda LOGIN, ale serwer może wymagać mechanizmu SASL, na przykład uzgodnionego przez rozszerzenie AUTHENTICATE. Dane logowania powinny być przesyłane wyłącznie w połączeniu chronionym szyfrowaniem.

Po uwierzytelnieniu klient może pobrać listę folderów komendą LIST lub LSUB. Aby operować na wiadomościach, wybiera skrzynkę komendą SELECT albo EXAMINE. SELECT otwiera folder w trybie pozwalającym na zmiany, natomiast EXAMINE służy do dostępu tylko do odczytu. Odpowiedź serwera zawiera między innymi liczbę wiadomości, liczbę wiadomości nieprzeczytanych oraz aktualny numer następnej wiadomości. Te informacje są ważne, ponieważ numery wiadomości mogą zmieniać się po modyfikacji zawartości folderu; stabilniejszym identyfikatorem w pracy aplikacyjnej jest zwykle UID.

Pobieranie, wyszukiwanie i zmiana stanu wiadomości

Do wyszukiwania wiadomości służy komenda SEARCH, która może filtrować dane według kryteriów określonych przez protokół, takich jak nadawca, odbiorca, temat, data, flaga przeczytania czy obecność określonego tekstu w nagłówku. W praktyce klient często korzysta z wariantu UID SEARCH, aby otrzymać identyfikatory UID zamiast numerów sekwencyjnych. Pobieranie danych odbywa się przez FETCH, na przykład w celu odczytania nagłówków, rozmiaru wiadomości, flag albo pełnej treści zapisanej jako RFC 822.

Komenda STORE pozwala zmieniać flagi wiadomości. Najczęściej używaną flagą jest \Seen, oznaczająca wiadomość jako przeczytaną. Inne standardowe flagi obejmują między innymi \Answered, \Flagged, \Deleted i \Draft. Usunięcie wiadomości w modelu IMAP nie zawsze oznacza natychmiastowe fizyczne skasowanie danych. Często klient najpierw ustawia flagę \Deleted, a trwałe usunięcie następuje po komendzie EXPUNGE. Przenoszenie wiadomości może być realizowane przez COPY do innego folderu, a następnie przez odpowiednią zmianę lub usunięcie kopii źródłowej.

IMAP API może również wykorzystywać komendę IDLE, zdefiniowaną w rozszerzeniu opisanym w RFC 2177, aby serwer informował klienta o nowych zdarzeniach bez ciągłego wykonywania zapytań. Dzięki temu aplikacja może szybciej odświeżać widok skrzynki, ale musi prawidłowo obsługiwać zakończenie trybu bezczynności, ponowne połączenia i czasowe rozłączenia. Przy większej liczbie wiadomości istotne są także pobieranie tylko potrzebnych fragmentów, używanie UID oraz unikanie wielokrotnego odczytu całych treści.

Bezpieczne użycie IMAP API na komputerze

Konfiguracja klienta IMAP wymaga podania adresu serwera, portu, metody szyfrowania oraz sposobu uwierzytelniania. Dla szyfrowanego połączenia IMAP najczęściej stosuje się port 993 z TLS od początku sesji. Port 143 jest standardowym portem IMAP i może być używany z mechanizmem STARTTLS, jeżeli serwer oraz klient prawidłowo negocjują przejście do połączenia szyfrowanego. Nie należy utożsamiać numeru portu z gwarancją bezpieczeństwa, ponieważ znaczenie ma także sprawdzenie certyfikatu serwera, poprawna metoda logowania i zgodność konfiguracji z wymaganiami dostawcy poczty.

Błędy działania IMAP API mogą wynikać z kilku różnych warstw. Niepoprawny adres serwera albo port uniemożliwia nawiązanie połączenia. Błąd certyfikatu wskazuje na problem z szyfrowaniem lub weryfikacją tożsamości serwera. Odrzucenie komendy LOGIN albo AUTHENTICATE może oznaczać błędne dane, wyłączony dostęp IMAP lub wymaganie innego mechanizmu logowania. Z kolei komunikaty dotyczące SELECT, FETCH albo STORE mogą wskazywać na brak folderu, niewystarczające uprawnienia, zmianę UID lub ograniczenia serwera. Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów i komputerów PC, w tym diagnostykę problemów z konfiguracją klienta pocztowego oraz komunikacją aplikacji z usługami internetowymi.