Основные команды. 
Разработка почтовой программы на основе протокола IMAP

Команда: AUTHENTIFICATE.

Аргументы: имя механизма аутентификации.

Описание: команда показывает серверу механизм аутентификации. Если сервер поддерживает указанный механизм, то выполняется обмен данными для аутентификации клиента;

Результат:

OK — аутентификация прошла успешно;

NO — неудача при аутентификации, неподдерживаемый механизм, нет полномочий;

BAD — команда не поддерживается или аргументы некорректны.

Команда: LOGIN.

Аргументы: имя пользователя, пароль.

Описание: используется для представления клиента серверу и передачи пароля и логина в виде открытого текста;

Результат:

OK — аутентификация прошла успешно;

NO — неудача, имя пользователя и пароль отвергнуты;

BAD — команда не поддерживается или аргументы некорректны.

Команда: LOGOUT.

Аргументы: отсутствуют.

Описание: информирует сервер о намерении клиента закончить работу;

Результат:

OK — команда выполнена.

BAD — команда не поддерживается или аргументы некорректны.

Команда: SELECT.

Аргументы: имя почтового ящика.

Описание: выбирает почтовый ящик и обеспечивает доступ к хранящимся в нем сообщениям. Сервер должен передать клиенту следующие данные для определения начального состояния почтового ящика:

FLAGS — флаги почтового ящика;

EXISTS — число сообщений в почтовом ящике;

RECENT — число сообщений с флагом Recent.

OK [UIDVALIDITY ] - уникальный идентификатор корректности.

В каждом соединении может быть выбран только 1 почтовый ящик. Для работы с несколькими ящиками требуется соответствующее число соединений. При выборе нового почтового ящика команда SELECT автоматически отменяет предыдущий выбор.

Результат:

OK — выбор завершен успешно;

NO — отказ при выборе;

BAD — команда не поддерживается или аргументы некорректны.

Команда: LSUB.

Аргументы: база, имя почтового ящика (возможны шаблоны).

Описание: возвращает список папок почтового ящика;

Результат:

OK — успешное завершение;

NO — неудача;

BAD — команда не поддерживается или аргументы некорректны.

Команда: STATUS.

Аргументы: имя почтового ящика, имена элементов состояния.

Описание: запрашивает сведения о состоянии указанного почтового ящика. Не меняет выбранный ящик и не влияет на состояние каких-либо сообщений в ящике.

Элементы состояния:

MESSAGES — число сообщений в почтовом ящике;

RECENT — число сообщений с флагом Recent;

UIDNEXT — значение UID, которое будет использовано для следующего сообщения;

UIDVALIDITY — значение идентификатора корректности для почтового ящика;

UNSEEN — число сообщений, для которых не установлен флаг Seen.

Результат:

OK — успешное завершение;

NO — неудача — для заданного имени нет данных о состоянии;

BAD — команда не поддерживается или аргументы некорректны.

Команда: CLOSE.

Аргументы: отсутствуют.

Описание: уничтожает в текущем почтовом ящике все сообщения с флагом Deleted и закрывает текущий почтовый ящик.

Результат:

OK — выбор ящика отменен;

NO — отказ — нет выбранного почтового ящика;

BAD — команда не поддерживается или аргументы некорректны.

Команда: EXPUNGE.

Аргументы: отсутствуют.

Описание: уничтожает в текущем почтовом ящике все сообщения с флагом Deleted.

Результат:

OK — удаление завершено;

NO — отказ — возможно, нет прав на удаление;

BAD — команда не поддерживается или аргументы некорректны.

Команда: SEARCH.

Аргументы: критерии поиска.

Описание: обеспечивает поиск в почтовом ящике сообщений, удовлетворяющих заданным критериям. Критерий поиска может содержать один или несколько ключей. Отклик сервера содержит список номеров найденных сообщений. К ключам поиска могут применяться логические операции OR, AND, NOT.

Со списком поддерживаемых ключей можно ознакомиться в RFC 2060.

Результат:

OK — удачное завершение поиска;

NO — ошибка при поиске;

BAD — команда не поддерживается или аргументы некорректны.

Команда: FETCH.

Аргументы: набор сообщений, имена элементов данных в сообщениях.

Описание: отыскивает данные, связанные с сообщениями в почтовом ящике. Отыскиваемые данные могут задаваться с помощью атома или списка в скобках.

Типы данных для выборки перечислены в RFC 2060.

Результат:

OK — успешная выборка;

NO — неудача при попытке выборки;

BAD — команда не поддерживается или аргументы некорректны.

Команда: STORE.

Аргументы: набор сообщений, значение для элемента данных сообщения.

Описание: изменяет данные для указанного сообщения в почтовом ящике. Могут изменяться следующие данные:

FLAGS — замена флагов сообщения. Новые значения флагов возвращаются в непомеченном отклике FETCH;

FLAGS.SILENT — эквивалент FLAGS, но без возврата отклика;

+FLAGS — добавления флага. Новые значения флагов возвращаются в непомеченном отклике FETCH;

+FLAGS.SILENT — эквивалент +FLAGS, но без возврата отклика;

• -FLAGS — удаление флага сообщения. Новые значения флагов возвращаются в непомеченном отклике FETCH;
• -FLAGS.SILENT — удаление флага сообщения, но без возврата отклика.

Результат:

OK — успешная запись;

NO — неудача;

BAD — команда не поддерживается или аргументы некорректны.

Команда: COPY.

Аргументы: набор сообщений, имя почтового ящика.

Описание: копирует заданные сообщения из текущего в конец заданного почтового ящика.

Результат:

OK — успешное копирование;

NO — неудача;

BAD — команда не поддерживается или аргументы некорректны.