Описание протокола
MMP - протокол соединения Mail.Ru Агента с общей сетью Mail.Ru. Рекомендованный для соединения сервер в любой момент времени можно получить в текстовом формате ip:port по адресу mrim.mail.ru:2042 и mrim.mail.ru:443. Взаимодействие с сервером происходит поверх постоянно установленного tcp-соединения посредством асинхронного обмена командами. Инициатором установления соединения может быть только клиент, команды могут посылаться как клиентом, так и сервером.
MMP бинарный протокол. Все числовые данные передаются как четырехбайтные целые НЕ в сетевом формате, т. е. первым идет старший байт, последним младший. Четырехбайтовые беззнаковые целые обозначаются UL.
Текстовые данные передаются с префексированной длиной, т. е. сначала UL, а потом строка (в кодировке windows-1251) длины UL без завершающего нуля. Обозначение в дальнейшем - LPS.
Тип данных UIDL используется только при работе с оставленными на сервере сообщениями. UIDL - последовательность из 8 символов из множества [a-z A-Z 0-9 _ - = +].
Каждая команда или ответ на нее начинаются с заголовка. Поля указываемые в заголовке:
волшебный ключ, указывающий на то, что это действительно пакет MMP - версия MMP, поддерживаемая отправителем пакета (текущая версия - 1.7)
номер отправляемой команды в текущем соединении. Ответ на команду должен иметь тот же номер, что и сама команда.
тип пакета, номер команды и/или ответа
длинна данных пакета (без учета заголовка). При обработке посылаемых сервером данных длина пакета должна иметь приоритет перед списком его параметров, т. к. в следующих версиях протокола могут появляться новые параметры и все они будут дописываться в конец пакета.
порт и ip (в inet_aton() формате) с которых установлено соединение
В синтаксисе языка С:
Заголовок пакета
{
u_long magic;
u_long proto;
u_long seq;
u_long msg;
u_long dlen;
u_long from;
u_long fromport;
u_char reserved[16];
}
Вам понадобится заголовочный файл на языке C. Взять его можно здесь.
Список кодов городов, населенных пунктов и районов можно взять здесь.
Последовательность команд
После установки tcp-соединения клиент обязан сразу послать MRIM_CS_HELLO, дождаться MRIM_CS_HELLO_ACK, после чего отправить MRIM_CS_LOGIN2 и начать посылать MRIM_CS_PING с установленным в MRIM_CS_HELLO_ACK интервалом. В случае успешной авторизации дальнейшие пакеты (кроме MRIM_CS_PING) должны отправляться только в случае пользовательских действий (написания новых сообщений и т. п.) или ответа на пакеты получаемые от сервера.
Типы пакетов
Тип пакета: cs - Client -> Server
Тип пакета: sc - Server -> Client
Пакеты
Пакет: Установка соединения
Имя пакета: MRIM_CS_HELLO
Ответ: MRIM_CS_HELLO_ACK
Тип пакета: cs
Описание: Первый пакет, отправляемый на сервер.
Пакет: Подтверждение установки соединения
Имя пакета: MRIM_CS_HELLO_ACK
Тип пакета: sc
Параметры:
UL ## ping_period ## Ожидаемая частота подтверждения соединения (в секундах)
Описание: Подтверждает возможность соединения и сообщает клиенту интервал, с которым надо отправлять пакеты контроля соединения.
Пакет: Успешная авторизация
Имя пакета: MRIM_CS_LOGIN_ACK
Тип пакета: sc
Описание: Сообщает, что пара логин-пароль была верна и клиент успешно авторизовался в сети агента.
Пакет: Неверная авторизация
Имя пакета: MRIM_CS_LOGIN_REJ
Тип пакета: sc
Параметры:
LPS ## reason ## причина отказа
Описание: Сообщает, что пара логин-пароль была неверна, и соединение будет завершено.
Пакет: Контроль соединения
Имя пакета: MRIM_CS_PING
Тип пакета: cs
Описание: Отправка этого пакета подтверждает для сервера, что клиент активен. Пакет должен отправляться с интервалом, определенным в MRIM_CS_HELLO_ACK.
Пакет: Сообщение
Имя пакета: MRIM_CS_MESSAGE
Тип пакета: cs
поле seq должно содержать номер, который в последствии будет содержаться в заголовке пакета MRIM_CS_MESSAGE_STATUS, оповещающем клиента о статусе доставки данного сообщения.
Параметры:
UL ## flags ## флаги ##
MESSAGE_FLAG_OFFLINE ## Сообщение пришло, пока клиент был отключен
MESSAGE_FLAG_NORECV ## Отправителю сообщения не требуется подтверждения доставки
MESSAGE_FLAG_AUTHORIZE ## Сообщение является запросом на авторизацию
MESSAGE_FLAG_SYSTEM ## Сообщение является системным уведомлением администрации
MESSAGE_FLAG_RTF ## В сообщении содержится форматированная часть
MESSAGE_FLAG_CONTACT ## Сообщение представляет из себя пересланный список контактов. Текст сообщения в этом случае должен представлять из себя список адресов и ников пересылаемых контактов, перечисленных через точку с запятой. <адрес1>;<ник1>;<адрес2>;<ник2>;<адрес3>;<ник3>;...
MESSAGE_FLAG_NOTIFY ## Это сообщение-уведомление "Вам пишут". Должно посылаться каждые 10 секунд, при более длинной паузе клиент-получатель должен считать, что отправитель прекратил написание. Текст такого сообщения должен состоять из одного пробела.
MESSAGE_FLAG_MULTICAST ##
Читать далее...