Îïèñàíèå ïðîòîêîëà
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 ## Ñîîáùåíèå íàïðàâëåíî ñïèñêó ïîëó÷àòåëåé, à íå îäíîìó. Ïîëå to â òàêîì ñëó÷àå ñîñòîèò èç ñïèñêà ïîëó÷àòåëåé, ïåðå÷èñëåííûõ ÷åðåç çàïÿòóþ. Ìàêñèìàëüíàÿ äëèíà ñïèñêà - 50 àäðåñîâ.
LPS ## to ## email ïîëó÷àòåëÿ
LPS ## message ## òåêñòîâàÿ âåðñèÿ îòïðàâëÿåìîãî ñîîáùåíèÿ
LPS ## rtf-message ## îòôîðìàòèðîâàííàÿ âåðñèÿ îòïðàâëÿåìîãî ñîîáùåíèÿ, â ñëó÷àå íàëè÷èÿ îáîèõ âåðñèé ñîîáùåíèÿ ïðèîðèòåò èìååò rtf-âåðñèÿ. Îíà äîëæíà ñîäåðæàòü rtf-òåêñò óïàêîâàííûé gzip â base64 ïðåäñòàâëåíèè. Òî åñòü:
BASE64(
GZIP(
UL êîëè÷åñòâî LPS (äîëæíî áûòü íå ìåíåå 2)
LPS rtf_text_with_all_rtf_headers_and_tags
LPS öâåò ôîíà â âèäå UL
)
)
Îïèñàíèå: Îñíîâíîé ïàêåò âçàèìîäåéñòâèÿ ìåæäó äâóìÿ êëèåíòàìè. Ìîæåò áûòü îòïðàâëåíî â ëþáîé ìîìåíò ïî èíèöèàòèâå êëèåíòà. Íè òåêñòîâàÿ, íè rtf ÷àñòè ñîîáùåíèé íå ìîãóò áûòü ïóñòûìè, ïðè íåîáõîäèìîñòè ñëåäóåò èñïîëüçîâàòü ñòðîêó èç îäíîãî ïðîáåëà.
Ïàêåò: Äîñòàâêà ñîîáùåíèÿ
Èìÿ ïàêåòà: MRIM_CS_MESSAGE_ACK
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## msg_id ## Íîìåð ïàêåòà (Sequence) ýòîãî ñîîáùåíèÿ äëÿ îòïðàâèòåëÿ
UL ## flags ## Âîçìîæíûå çíà÷åíèÿ îïèñàíû â MRIM_CS_MESSAGE
LPS ## from ## Àäðåñ îòïðàâèòåëÿ
LPS ## message ## òåêñòîâàÿ âåðñèÿ ñîîáùåíèÿ
LPS ## rtf-message ## ôîðìàòèðîâàííàÿ âåðñèÿ ñîîáùåíèÿ
Îïèñàíèå:
Ïàêåò: Ïîäòâåðæäåíèå ïîëó÷åíèÿ ñîîáùåíèÿ
Èìÿ ïàêåòà: MRIM_CS_MESSAGE_RECV
Òèï ïàêåòà: cs
Ïàðàìåòðû:
LPS ## from ##
UL ## msg_id ##
Îïèñàíèå: Îòïðàâëÿåòñÿ ïîëó÷àòåëåì ñîîáùåíèÿ ñðàçó ïîñëå ïðèõîäà MRIM_CS_MESSAGE_ACK, åñëè ôëàãè MRIM_CS_MESSAGE_ACK íå ñîäåðæàëè MESSAGE_FLAG_NORECV. from è msg_id äîëæíû áûòü ñêîïèðîâàíû èç MRIM_CS_MESSAGE_ACK è èìåþò òî æå çíà÷åíèå.
Ïàêåò: Ïîäòâåðæäåíèå äîñòàâêè ñîîáùåíèÿ
Èìÿ ïàêåòà: MRIM_CS_MESSAGE_STATUS
Òèï ïàêåòà: sc
Ïîëå seq ÷èñëåííî ðàâíî ïîëþ seq ïàêåòà MRIM_CS_MESSAGE
Ïàðàìåòðû:
UL ## status ## ñòàòóñ äîñòàâêè ##
MESSAGE_DELIVERED ## Ñîîáùåíèå óñïåøíî äîñòàâëåíî
MESSAGE_REJECTED_INTERR ## Ïðîèçîøëà âíóòðåííÿÿ îøèáêà
MESSAGE_REJECTED_NOUSER ## Íå ñóùåñòâóåò ïîëüçîâàòåëÿ-ïîëó÷àòåëÿ ñîîáùåíèÿ
MESSAGE_REJECTED_LIMIT_EXCEEDED ## Ïîëüçîâàòåëü-ïîëó÷àòåëü â äàííûé ìîìåíò îòêëþ÷åí îò ñåòè, è ñîîáùåíèå íå ïîìåùàåòñÿ â åãî ïî÷òîâûé ÿùèê
MESSAGE_REJECTED_TOO_LARGE ## Ðàçìåð ñîîáùåíèÿ ïðåâûøàåò ìàêñèìàëüíî äîïóñòèìûé
MESSAGE_REJECTED_DENY_OFFMSG ## Ïîëüçîâàòåëü-ïîëó÷àòåëü â äàííûé ìîìåíò îòêëþ÷åí îò ñåòè, à íàñòðîéêè åãî ïî÷òîâîãî ÿùèêà íå äîïóñêàþò íàëè÷èå îôôëàéíîâûõ ñîîáùåíèé àãåíòà
Îïèñàíèå: Îòïðàâëåííîå ñîîáùåíèå ñ÷èòàåòñÿ äîñòàâëåííûì òîëüêî ïîñëå ïîëó÷åíèÿ ýòîãî îòâåòà ñåðâåðà. Ñåðâåð ÍÅ ÃÀÐÀÍÒÈÐÓÅÒ äîñòàâêó ñîîáùåíèÿ.  ñëó÷àå îòñòóòñòâèÿ MRIM_CS_MESSAGE_STATUS áîëåå èíòåðâàëà ïîäòâåðæäåíèÿ ñîåäèíåíèÿ, ïðîãðàììà êëèåíò äîëæíà ïîñëàòü ñîîáùåíèå ïîâòîðíî èëè ïðîèíôîðìèðîâàòü ïîëüçîâàòåëÿ î íåâîçìîæíîñòè äîñòàâêè èç-çà ïðîáëåì ñâÿçè ïîëó÷àòåëÿ.
Ïàêåò: Ñìåíà ñòàòóñà äðóãîãî ïîëüçîâàòåëÿ
Èìÿ ïàêåòà: MRIM_CS_USER_STATUS
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## status ## íîâûé ñòàòóñ ïîëüçîâàòåëÿ ##
STATUS_OFFLINE ## Ïîëüçîâàòåëü îòêëþ÷åí îò ñåòè Àãåíòà
STATUS_ONLINE ## Ïîëüçîâàòåëü íàõîäèòñÿ â ñåòè
STATUS_AWAY ## Ïîëüçîâàòåëü â ñåòè, íî îòîøåë îò êîìïüþòåðà
STATUS_UNDETERMINATED ## Íàñòðîéêè ïîëüçîâàòåëÿ çàïðåùàþò ïîêàçûâàòü åãî ñòàòóñ
STATUS_FLAG_INVISIBLE ## Ïîëüçîâàòåëü íàõîäèòñÿ â ñåòè, íî íåâèäèì äëÿ âñåõ, êðîìå ïðèâèëåãèðîâàííûõ ïîëüçîâàòåëåé èç åãî ñïèñêà âèäèìîñòè.
LPS ## user ## email ñìåíèâøåãî ñâîé ñòàòóñ ïîëüçîâàòåëÿ
Îïèñàíèå: Ýòî ñîîáùåíèå îòïðàâëÿåòñÿ ñåðâåðîì ïðè ñìåíå ñòàòóñà ïîëüçîâàòåëÿì âñåì òåì, ó êîãî îí íàõîäèòñÿ â êîíòàêò-ëèñòå (çà èñêëþ÷åíèåì ãðóïïû "Æäó Àâòîðèçàöèè" è òåõ, êîãî îí âêëþ÷èë â ñïèñîê èãíîðèðóåìûõ èëè íåâèäÿùèõ). Äàííîå ñîîáùåíèå ìîæåò áûòü äîñòàâëåíî êëèåíòó ÄÎ ïîëó÷åíèÿ èì êîíòàêò-ëèñòà.  òàêîé ñèòóàöèè îíî äîëæíî èãíîðèðîâàòüñÿ.
Ïàêåò: Çàêðûòèå ñîåäèíåíèÿ
Èìÿ ïàêåòà: MRIM_CS_LOGOUT
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## reason ## ïðè÷èíà îòêëþ÷åíèÿ ##
LOGOUT_NO_RELOGIN_FLAG ## Ïîëüçîâàòåëü îòêëþ÷åí èç-çà ïàðàëëåëüíîãî âõîäà ñ åãî ëîãèíîì. Êëèåíò íå äîëæåí îñóùåñòâëÿòü àâòîìàòè÷åñêèé ïåðåçàõîä â ýòîì ñëó÷àå.
Ïàêåò: Èçìåíåíèå ïàðàìåòðîâ ñîåäèíåíèÿ
Èìÿ ïàêåòà: MRIM_CS_CONNECTION_PARAM
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## ping_period ## íîâàÿ îæèäàåìàÿ ÷àñòîòà ïîäòâåðæäåíèÿ ñîåäèíåíèÿ
Îïèñàíèå: Áëèæàéøèé MRIM_CS_PING ñëåäóåò îòïðàâëÿòü óæå èñõîäÿ èç íîâîé ÷àñòîòû.
Ïàêåò: Äîáàâëåíèå íîâîãî êîíòàêòà
Èìÿ ïàêåòà: MRIM_CS_ADD_CONTACT
Òèï ïàêåòà: cs
Ïàðàìåòðû:
UL ## flags ## ôëàãè ##
CONTACT_FLAG_GROUP ## Äîáàâëÿåòñÿ íîâàÿ ãðóïïà, à íå êîíòàêò (íåñîâìåñòèì ñ îñòàëüíûìè). Âåðõíèé áàéò ñîäåðæèò êîëè÷åñòâî óæå èìåþùèõñÿ ãðóïï â êîíòàêò-ëèñòå
CONTACT_FLAG_INVISIBLE ## Êîíòàêò äîëæåí ïîïàñòü â ñïèñîê "ß âñåãäà íåâèäèì äëÿ"
CONTACT_FLAG_VISIBLE ## Êîíòàêò äîëæåí ïîïàñòü â ñïèñîê "ß âñåãäà âèäèì äëÿ"
CONTACT_FLAG_IGNORE ## Êîíòàêò äîëæåí ïîïàñòü â ñïèñîê èãíîðèðóåìûõ
CONTACT_FLAG_SHADOW ## Êîíòàêò íå äîëæåí ïîïàñòü â îñíîâíîé êîíòàêò-ëèñò (ïðèìåíÿåòñÿ â ïàðå ñ îäíèì èç òðåõ ïðåäûäóùèõ)
CONTACT_FLAG_REMOVED ## Êîíòàêò óäàëåí
UL ## group_id ## ãðóïïà, â êîòîðóþ äîëæåí áûòü äîáàâëåí êîíòàêò (äëÿ CONTACT_FLAG_GROUP ðàâíî 0)
LPS ## email ## äîáàâëÿåìûé àäðåñ (èìÿ ãðóïïû äëÿ CONTACT_FLAG_GROUP)
LPS ## name ## íèê äîáàâëÿåìîãî ïîëüçîâàòåëÿ (äëÿ îòîáðàæåíèÿ â êîíòàêò-ëèñòå, íå ïîñûëàåòñÿ äëÿ CONTACT_FLAG_GROUP) LPS ## unused ## íåèñïîëüçóåìûé ïàðàìåòð
Ïàêåò: Ïîäòâåðæäåíèå äîáàâëåíèÿ êîíòàêòà
Èìÿ ïàêåòà: MRIM_CS_ADD_CONTACT_ACK
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## status ## ðåçóëüòàò îïåðàöèè ##
CONTACT_OPER_SUCCESS ## äîáàâëåíèå ïðîèçâåäåíî óñïåøíî
CONTACT_OPER_ERROR ## ïåðåäàííûå äàííûå áûëè íåêîððåêòíû
CONTACT_OPER_INTERR ## ïðè îáðàáîòêå çàïðîñà ïðîèçîøëà âíóòðåííÿÿ îøèáêà
CONTACT_OPER_NO_SUCH_USER ## äîáàâëÿåìîãî ïîëüçîâàòåëÿ íå ñóùåñòâóåò â ñèñòåìå
CONTACT_OPER_INVALID_INFO ## íåêîððåêòíîå èìÿ ïîëüçîâàòåëÿ
CONTACT_OPER_USER_EXISTS ## ïîëüçîâàòåëü óæå åñòü â êîíòàêò-ëèñòå
CONTACT_OPER_GROUP_LIMIT ## ïðåâûøåíî ìàêñèìàëüíî äîïóñòèìîå êîëè÷åñòâî ãðóïï (20)
## UL ## contact_id ## ïðèñâîåííûé íîâîìó êîíòàêòó íîìåð
Îïèñàíèå: Ïðèõîäèò â îòâåò íà MRIM_CS_ADD_CONTACT. -1 åñëè status íå ðàâåí CONTACT_OPER_SUCCESS.
Ïàêåò: Èçìåíåíèå êîíòàêòà
Èìÿ ïàêåòà: MRIM_CS_MODIFY_CONTACT
Òèï ïàêåòà: cs
Ïàðàìåòðû:
UL ## id ## íîìåð ìîäèôèöèðóåìîãî êîíòàêòà
UL ## flags ##
UL ## group_id ## Ðàâíî 0 äëÿ ãðóïïû
LPS ## contact ## Åñëè ãðóïïà, òî èìÿ ãðóïïû
LPS ## name ## Åñëè ãðóïïà, òî èìÿ ãðóïïû
Îïèñàíèå: Ïàðàìåòðû òå æå, ÷òî è ó MRIM_CS_ADD_CONTACT. contact äî è ïîñëå èçìåíåíèÿ îáÿçàíû ñîâïàäàòü.
Ïàêåò: Ïîäòâåðæäåíèå èçìåíåíèÿ êîíòàêòà
Èìÿ ïàêåòà: MRIM_CS_MODIFY_CONTACT_ACK
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## status ## Ðåçóëüòàò îïåðàöèè. Çíà÷åíèÿ èìåþò òîò æå ñìûñë, ÷òî è â MRIM_CS_ADD_CONTACT_ACK
Ïàêåò: Ñîîáùåíèå äîñòàâëåííîå, ïîêà ïîëüçîâàòåëü íå áûë ïîäêëþ÷åí ê ñåòè
Èìÿ ïàêåòà: MRIM_CS_OFFLINE_MESSAGE_ACK
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UIDL ## uidl ## id ñîîáùåíèÿ
LPS ## message ## ñîîáùåíèå. Ñîîáùåíèå ïðèõîäèò â ôîðìàòå RFC/822 ïèñüìà. Îòïðàâèòåëü ñîîáùåíèÿ õðàíèòñÿ â çàãîëîâêå From, äàòà â çàãîëîâêå Date, ôëàãè ñîîáùåíèÿ â X-MRIM-FLAGS, òåêñòîâàÿ è ôîðìàòèðîâàííàÿ âåðñèè ñîîáùåíèÿ ñîñòàâëÿþò òåêñò ïèñüìà è ðàçäåëÿþòñÿ ìåæäó ñîáîé ðàçäåëèòåëåì èç çàãîëîâêà Boundary.
Îïèñàíèå: Êàæäîå ïîëó÷åííîå çà âðåìÿ îòñóòñòâèÿ ñîîáùåíèå ïðèõîäèò îòäåëüíûì ïàêåòîì â òîì ïîðÿäêå, â êàêîì îíè ïîñòóïàëè íà ñåðâåð.
Ïàêåò: Óäàëåíèå ñîõðàíåííîãî ñîîáùåíèÿ
Èìÿ ïàêåòà: MRIM_CS_OFFLINE_MESSAGE_DEL
Òèï ïàêåòà: cs
Ïàðàìåòðû:
UIDL ## uidl
Îïèñàíèå: Íà êàæäûé ïîëó÷åííûé MRIM_CS_OFFLINE_MESSAGE_ACK êëèåíò îáÿçàí îòïðàâèòü MRIM_CS_OFFLINE_MESSAGE_DEL ñ òåì æå uidl, ïîäòâåðæäàþùèé ïîëó÷åíèå äàííîãî ñîîáùåíèÿ. Ñîîáùåíèå ñòèðàåòñÿ íà ñåðâåðå òîëüêî ïðè ïîëó÷åíèè ýòîé êîìàíäû.
Ïàêåò: Àâòîðèçàöèÿ ïîëüçîâàòåëÿ íà äîáàâëåíèå â êîíòàêò-ëèñò
Èìÿ ïàêåòà: MRIM_CS_AUTHORIZE
Òèï ïàêåòà: cs
Ïàðàìåòðû:
LPS ## user ## email ïîëüçîâàòåëÿ
Îïèñàíèå: Îòïðàâëÿåòñÿ, ÷òîáû ðàçðåøèòü user äîáàâëåíèå ïîëüçîâàòåëÿ â êîíòàêò-ëèñò è íàáëþäåíèå çà åãî ñòàòóñîì.
Ïàêåò: Èíôîðìàöèÿ îá àâòîðèçàöèè
Èìÿ ïàêåòà: MRIM_CS_AUTHORIZE_ACK
Òèï ïàêåòà: sc
Ïàðàìåòðû:
LPS ## user ## email àâòîðèçîâàâøåãî ïîëüçîâàòåëÿ
Îïèñàíèå: Îòñûëàåòñÿ ñåðâåðîì ïîñëå ïîëó÷åíèåì èì MRIM_CS_AUTHORIZE îò user òîìó, êîãî user àâòîðèçîâàë.
Ïàêåò: Èçìåíåíèå ñòàòóñà
Èìÿ ïàêåòà: MRIM_CS_CHANGE_STATUS
Òèï ïàêåòà: cs
Ïàðàìåòðû:
UL ## status ## âîçìîæíûå çíà÷åíèÿ ñîâïàäàþò ñ MRIM_CS_USER_STATUS, íî íå ìîãóò ïîñûëàòüñÿ ñòàòóñû STATUS_UNDETERMINATED è STATUS_OFFLINE
Ïàêåò: Òðåáîâàíèå êëþ÷à äëÿ web-àâòîðèçàöèè
Èìÿ ïàêåòà: MRIM_CS_GET_MPOP_SESSION
Òèï ïàêåòà: cs
Îïèñàíèå: Ïîëüçîâàòåëü àãåíòà ìîæåò çàõîäèòü â ïî÷òîâûé ÿùèê Mail.Ru áåç äîïîëíèòåëüíîé àâòîðèçàöèè è íå ïåðåäàâàÿ ñâîé ïàðîëü â GET-çàïðîñå, äëÿ ýòîãî èñïîëüçóåòñÿ ìåõàíèçì êëþ÷åé.
Ïàêåò: Êëþ÷ äëÿ web-àâòîðèçàöèè
Èìÿ ïàêåòà: MRIM_CS_GET_MPOP_SESSION_ACK
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## status ## óñïåøíîñòü îïåðàöèè (1 - êëþ÷ ïîëó÷åí, 0 - ïðîèçîøëà îøèáêà)
LPS ## session ## ñàì êëþ÷
Îïèñàíèå: Äëÿ âõîäà â ÿùèê ìîæíî èñïîëüçîâàòü URL win.mail.ru/cgi-bin/auth?Login=email&agent=êëþ÷.
Ïàêåò: Ïîèñê êîíòàêòà
Èìÿ ïàêåòà: MRIM_CS_WP_REQUEST
Òèï ïàêåòà: cs
Ïàðàìåòðû:
UL ## field ## ïàðàìåòð ïîèñêà ##
MRIM_CS_WP_REQUEST_PARAM_USER ## ëîãèí (áåç äîìåíà), îáÿçàí êîìáèíèðîâàòüñÿ ñ äîìåíîì
MRIM_CS_WP_REQUEST_PARAM_DOMAIN ## ïî÷òîâûé äîìåí
MRIM_CS_WP_REQUEST_PARAM_NICKNAME ## íèê
MRIM_CS_WP_REQUEST_PARAM_FIRSTNAME ## èìÿ
MRIM_CS_WP_REQUEST_PARAM_LASTNAME ## ôàìèëèÿ, * â êîíöå íèêà/èìåíè/ôàìèëèè óêàçûâàåò íà âîçìîæíîñòü ëþáîãî ïðîäîëæåíèÿ èìåíè
MRIM_CS_WP_REQUEST_PARAM_SEX ## ïîë. 1 - ìóæñêîé, 2 - æåíñêèé
MRIM_CS_WP_REQUEST_PARAM_DATE1 ## ìèíèìàëüíûé âîçðàñò (â ãîäàõ)
MRIM_CS_WP_REQUEST_PARAM_DATE2 ## ìàêñèìàëüíûé âîçðàñò (â ãîäàõ)
MRIM_CS_WP_REQUEST_PARAM_CITY_ID ## ID ðåãèîíà ïðîæèâàíèÿ
MRIM_CS_WP_REQUEST_PARAM_ZODIAC ## Çíàê çîäèàêà (Îâåí - 1, ..., Ðûáû - 12)
MRIM_CS_WP_REQUEST_PARAM_BIRTHDAY_MONTH ## Ìåñÿö ðîæäåíèÿ (ßíâàðü - 1, ..., Äåêàáðü - 12)
MRIM_CS_WP_REQUEST_PARAM_BIRTHDAY_DAY ## Äåíü ðîæäåíèÿ (îáÿçàí êîìáèíèðîâàòüñÿ ñ ìåñÿöåì ðîæäåíèÿ)
MRIM_CS_WP_REQUEST_PARAM_COUNTRY_ID ## ID ñòðàíû ïðîæèâàíèÿ
MRIM_CS_WP_REQUEST_PARAM_ONLINE ## èùåì ëè ìû òîëüêî ïîäêëþ÷åííûõ â äàííûé ìîìåíò ïîëüçîâàòåëåé (1)
LPS ## value âñå ïàðàìåòðû â ñòðîêîâîì ôîðìàòå, âêëþ÷àÿ ÷èñëà
Îïèñàíèå: Ïîèñê êîíòàêòîâ â áàçå àãåíòà. Ïàðàìåòðû ïîèñêà ïåðåäàþòñÿ ïàðàìè ïàðàìåòð-çíà÷åíèå. Ïåðåäà÷à íåñêîëüêèõ ïàðàìåòðîâ èìååò ñåìàíòèêó "è", ò. å. âñå íàéäåííûå ðåçóëüòàòû äîëæíû ñîîòâåòñòâîâàòü âñåì ïåðåäàííûì ïàðàìåòðàì. Êîìáèíèðîâàòüñÿ ìîãóò âñå ïàðàìåòðû çà èñêëþ÷åíèåì ëîãèíà è äîìåíà (îíè îáÿçàíû èäòè ïàðîé è íå ìîãóò êîìáèíèðîâàòüñÿ ñ äðóãèìè ïàðàìåòðàìè) â ïîðÿäêå ñîîòâåòñòâóþùåì ïîðÿäêó îïèñàíèÿ (çà èñêëþ÷åíèåì òðåáîâàíèÿ äëÿ MRIM_CS_WP_REQUEST_PARAM_ONLINE áûòü ïîñëåäíèì â ñïèñêå).
Ïàêåò: Íàéäåííûå ïîëüçîâàòåëè
Èìÿ ïàêåòà: MRIM_CS_ANKETA_INFO
Òèï ïàêåòà: cs
Ïàðàìåòðû:
UL ## status ## óñïåøíîñòü çàïðîñà ##
MRIM_ANKETA_INFO_STATUS_OK ## ïîèñê óñïåøíî çàâåðøåí
MRIM_ANKETA_INFO_STATUS_NOUSER ## íå íàéäåíî íè îäíîé ïîäõîäÿùåé çàïèñè
MRIM_ANKETA_INFO_STATUS_RATELIMERR ## ñëèøêîì ìíîãî çàïðîñîâ, ïîèñê âðåìåííî çàïðåùåí
UL ## fields_num ## êîëè÷åñòâî ïîëåé â àíêåòå êàæäîãî ïîëüçîâàòåëÿ
UL ## max_rows ## òåêóùåå îãðàíè÷åíèå íà êîëè÷åñòâî ðåçóëüòàòîâ ïîèñêà (ìîæåò áûòü áîëüøå, ÷åì êîëè÷åñòâî ñòðîê â äàííîì îòâåòå)
UL ## server_time ## òåêóùåå âðåìÿ íà ñåðâåðå (äîëæíî èñïîëüçîâàòüñÿ äëÿ âû÷èñëåíèÿ âîçðàñòà). Ôîðìàò âðåìåíè: Êîëè÷åñòâî ñåêóíä ñ 00:00:00 1 ÿíâàðÿ 1970 ãîäà.
LPS, LPS, ... ## fields ## íàçâàíèÿ ïîëåé òåêóùåé àíêåòû (âñåãî fields_num øòóê)
LPS, LPS, ... ## values ## çíà÷åíèÿ ïîëåé àíêåòû äëÿ êàæäîãî íàéäåííîãî ïî çàïðîñó ïîëüçîâàòåëÿ â òîì æå ïîðÿäêå, ÷òî â ñïèñêå ïîëåé, ïî fields_num øòóê íà êàæäîãî
Îïèñàíèå: Ðåçóëüòàò ïîèñêà êîíòàêòîâ. Âîçâðàùàåò àíêåòû íàéäåííûõ ïîëüçîâàòåëåé (èõ àäðåñà ÿâëÿþòñÿ ïîëÿìè àíêåòû).
Ïàêåò: Êîëè÷åñòâî ïèñåì â ïî÷òîâîì ÿùèêå
Èìÿ ïàêåòà: MRIM_CS_MAILBOX_STATUS
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## status ## êîëè÷åñòâî íåïðî÷èòàííûõ ïèñåì
Îïèñàíèå: Ïðèõîäèò ïðè ïîëó÷åíèè íîâîé ïî÷òû èëè ëþáîì äðóãîì èçìåíåíèè ÷èñëà íåïðî÷èòàííûõ ïèñåì â ÿùèêå.
Ïàêåò: Êîíòàêò-ëèñò
Èìÿ ïàêåòà: MRIM_CS_CONTACT_LIST2
Òèï ïàêåòà: sc
Ïàðàìåòðû:
UL ## status ## ðåçóëüòàò çàïðîñà êîíòàêò-ëèñòà
GET_CONTACTS_OK ## ïîèñê âûïîëíåí óñïåøíî
GET_CONTACTS_ERROR ## íàéäåííûé êîíòàêò-ëèñò íåêîððåêòåí
GET_CONTACTS_INTERR ## ïðîèçîøëà âíóòðåííÿÿ îøèáêà
UL ## groups_number ## êîëè÷åñòâî ãðóïï â êîíòàêò-ëèñòå
LPS ## group_mask ## ìàñêà-îïèñàíèå ãðóïïû, ñîñòîèò èç ñèìâîëîâ 's' (LPS),'u' (UL),'z' (ñòðîêà îêàí÷èâàþùàÿñÿ áèíàðíûì íóëåì, â äàííûé ìîìåíò íå èñïîëüçóåòñÿ), ñåé÷àñ "us" - ôëàãè è íàçâàíèå, ïðè ðàñøèðåíèè îïèñàíèÿ ñòàðûå ïîëÿ ñîõðàíÿò ñâîå ðàñïîëîæåíèå
LPS ## contacts_mask ## ìàñêà-îïèñàíèå ïîëüçîâàòåëÿ (ñèíòàêñèñ òàêîé æå êàê è ó group_mask), ñåé÷àñ uussuu (ôëàãè, ãðóïïà, àäðåñ, íèê, ñåðâåðíûå ôëàãè, òåêóùèé ñòàòóñ â ñåòè)
## groups ## ãðóïïû (âñåãî groups_number øòóê)
## contacts ## êîíòàêòû
Îïèñàíèå: Êîíòàêò-ëèñò ïîëüçîâàòåëÿ õðàíèòñÿ íà ñåðâåðå. Êëèåíò ìîæåò õðàíèòü ëîêàëüíóþ êîïèþ êîíòàêò-ëèñòà, íî ñåðâåðíàÿ äîëæíà èìåòü ïðèîðèòåò. Ôëàãè êîíòàêòà èìåþò òîò æå ñìûñë, ÷òî â MRIM_CS_ADD_CONTACT, ñòàòóñ - òîò æå ñìûñë, ÷òî â MRIM_CS_USER_STATUS. Ñåðâåðíûé ôëàã â äàííûé ìîìåíò îïðåäåë¸í îäèí - CONTACT_INTFLAG_NOT_AUTHORIZED îçíà÷àåò, ÷òî êîíòàêò åùå íå àâòîðèçîâàë ïîëüçîâàòåëÿ è íàõîäèòñÿ â ãðóïïå "Æäó àâòîðèçàöèè". Åñëè ìàñêà êîíòàêòà èëè ãðóïïû ñîäåðæèò áîëüøå ñèìâîëîâ, ÷åì íåîáõîäèìî, êëèåíò äîëæåí ïðî÷èòàòü çíà÷åíèÿ ýòèõ ïîëåé è ïðîèãíîðèðîâàòü èõ.
Ïàêåò: Èíôîðìàöèÿ î ïîëüçîâàòåëå
Èìÿ ïàêåòà: MRIM_CS_USER_INFO
Òèï ïàêåòà: sc
Ïàðàìåòðû:
LPS, LPS, ... ##name1, value1, name2, value2, ... ## äîïîëíèòåëüíàÿ èíôîðìàöèÿ î ïîëüçîâàòåëå, èìÿ ïàðàìåòðà, çíà÷åíèå ïàðàìåòðà, èìÿ ïàðàìåòðà, çíà÷åíèå ïàðàìåòðà, ... Íà äàííûé ìîìåíò îïðåäåëåíû MESSAGES.TOTAL - êîëè÷åñòâî ïèñåì â ÿùèêå, MESSAGES.UNREAD - êîëè÷åñòâî íåïðî÷èòàííûõ ïèñåì â ÿùèêå, MRIM.NICKNAME - íèê ïîëüçîâàòåëÿ
Ïàêåò: Àâòîðèçàöèÿ
Èìÿ ïàêåòà: MRIM_CS_LOGIN2
Òèï ïàêåòà: cs
Ïàðàìåòðû:
LPS ## login ## email àâòîðèçóþùåãîñÿ ïîëüçîâàòåëÿ
LPS ## password ## ïàðîëü
UL ## status ## ñòàòóñ (ñì. MRIM_CS_CHANGE_STATUS)
LPS ## user_agent ## òåêñòîâîå îïèñàíèå êëèåíòà ïîëüçîâàòåëÿ, íàïðèìåð "Mail.Ru Miranda Plugin v 1.0"