IMAP APPEND

IMAP APPEND to polecenie tego protokołu umożliwiające dodanie nowej wiadomości do wskazanego folderu na serwerze.

Rola polecenia APPEND w protokole IMAP

IMAP APPEND jest poleceniem protokołu IMAP służącym do zapisania nowej wiadomości w wybranym folderze skrzynki pocztowej znajdującej się na serwerze. W odróżnieniu od wysłania wiadomości przez SMTP, APPEND nie przekazuje jej adresatom i nie uruchamia procesu dostarczania poczty. Klient pocztowy przekazuje serwerowi gotową treść wiadomości w formacie MIME, a serwer umieszcza ją jako element wskazanej skrzynki, na przykład w folderze „Drafts”, „Sent” albo w folderze utworzonym przez użytkownika.

Operacja jest wykonywana w ramach istniejącej sesji IMAP po uwierzytelnieniu klienta. Serwer sprawdza, czy wskazana skrzynka istnieje oraz czy zalogowane konto ma prawo zapisywać w niej wiadomości. Jeżeli warunki są spełnione, wiadomość otrzymuje numer sekwencyjny zgodny z aktualnym stanem folderu. Numer ten może później służyć do odwoływania się do wiadomości w tej konkretnej sesji, ale nie powinien być traktowany jako trwały identyfikator przechowywanego elementu.

Składnia i dane przekazywane do serwera

Typowa postać polecenia obejmuje znacznik żądania, słowo APPEND, nazwę docelowej skrzynki oraz literał zawierający pełną wiadomość. Przykładowo klient może wysłać polecenie w rodzaju A001 APPEND "Drafts" {342}, a następnie przekazać dokładnie 342 oktety danych wiadomości. Wartość w nawiasach klamrowych określa długość przesyłanego bloku w oktetach, a nie liczbę znaków widocznych dla użytkownika. Ma to znaczenie przy kodowaniu UTF-8, znakach wielobajtowych, nagłówkach MIME i danych binarnych załączników.

Opcjonalnie przed literałem można przekazać listę flag wiadomości oraz datę i czas wewnętrzny elementu. Flagi opisują stan wiadomości, na przykład jej oznaczenie jako przeczytanej lub usuniętej, natomiast wewnętrzna data pozwala zachować czas przypisany do elementu przez klienta. Sama treść musi być poprawną wiadomością internetową: powinna zawierać nagłówki, pustą linię oddzielającą nagłówki od treści oraz właściwe kodowanie transferowe dla części tekstowych i załączników. Niepoprawna długość literału, uszkodzone zakończenie linii albo nieprawidłowa struktura MIME mogą spowodować odrzucenie żądania.

APPEND a synchronizacja folderu pocztowego

Po pomyślnym wykonaniu APPEND serwer odpowiada statusem zakończenia operacji. W podstawowym wariancie odpowiedź potwierdza zapisanie wiadomości, ale nie musi zwracać jej trwałego identyfikatora. Klient, który chce jednoznacznie odnaleźć właśnie dodany element, może korzystać z rozszerzenia UIDPLUS, jeżeli serwer je ogłasza w odpowiedzi CAPABILITY. W takim przypadku odpowiedź może zawierać kod APPENDUID z identyfikatorem UID przydzielonym w docelowej skrzynce oraz z informacją o UIDVALIDITY.

UID jest stabilniejszym od numeru sekwencyjnego sposobem wskazywania wiadomości, lecz jego interpretacja zależy od konkretnego folderu i wartości UIDVALIDITY. Po zmianie tej wartości wcześniej zapamiętane UID-y nie mogą być bezwarunkowo używane do identyfikacji elementów. Klient powinien także odświeżyć stan folderu, ponieważ inne urządzenie lub proces synchronizacyjny może w tym samym czasie dodać, usunąć albo zmienić wiadomości. Problemy z duplikatami w folderze „Wysłane” często wynikają z wykonania APPEND przez klienta połączonego z osobnym zapisaniem kopii przez serwer SMTP lub regułę serwera pocztowego.

Gdy zapis wiadomości nie przebiega prawidłowo

Diagnostyka problemu z IMAP APPEND wymaga rozdzielenia kilku etapów: połączenia z właściwym serwerem, uwierzytelnienia, wyboru folderu, sprawdzenia uprawnień oraz przesłania kompletnego literału. Odpowiedź NO może wskazywać między innymi na brak prawa zapisu, nieistniejącą skrzynkę, ograniczenie rozmiaru wiadomości albo odrzucenie jej przez filtr serwera. Odpowiedź BAD zwykle oznacza błąd składni lub niezgodność komunikacji z możliwościami serwera. Samo poprawne zalogowanie do poczty nie dowodzi jeszcze, że konto może wykonywać APPEND w każdym folderze.

Na komputerze warto sprawdzić, czy problem występuje w jednym programie pocztowym, czy także w innym kliencie korzystającym z tego samego konta. Przydatne są również informacje o nazwie folderu przekazywanej przez klienta, kodowaniu wiadomości, rozmiarze załączników oraz odpowiedzi serwera IMAP. Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów i komputerów PC, w tym diagnostykę problemów z konfiguracją popularnych programów pocztowych, gdy błędna obsługa IMAP APPEND wynika z ustawień lub nieprawidłowego działania komputera.