current version
[opsoft_test.git] / gclib2 / modules / Net / MMP / protocol.html
blob6bdb9d8b5542fc7d99fa71b95da948f57a01cb87
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <title> Mail.ru Àãåíò</title>
5 <meta name="DESCRIPTION" content="Íàöèîíàëüíàÿ ïî÷òîâàÿ ñëóæáà @Mail.ru - ëó÷øàÿ áåñïëàòíàÿ ïî÷òà. Äîñòóï ê ïî÷òå ÷åðåç POP/SMTP, âåá- è wap-èíòåðôåéñ. Òàêæå íà ïîðòàëå: àâòî, íîâîñòè, ñïîðò, ìóçûêà, ðàáîòà, çíàêîìñòâà, àíåêäîòû, îòêðûòêè, ïîãîäà">
6 <meta name="Keywords" content="ïî÷òà, áåñïëàòíàÿ ýëåêòðîííàÿ ïî÷òà, àâòî, íîâîñòè, ñïîðò, ìóçûêà, ðàáîòà, çíàêîìñòâà, àíåêäîòû, îòêðûòêè, ïîãîäà">
7 <meta http-equiv="content-type" content="text/html; charset=windows-1251">
9 <link rel=stylesheet type=text/css href=index.css>
10 <link href="proto.css" rel="stylesheet" type="text/css">
11 </head>
13 <body bgcolor=white leftmargin=0 rightmargin=0 topmargin=0 bottommargin=0 marginheight=0 marginwidth=0>
14 <center>
16 <table cellpadding=0 cellspacing=0 border=0 width=90% class=top_menu><tr>
17 <td class=bord_l><img src=http://img.mail.ru/0.gif width=11 height=1></td>
18 <td nowrap><a href=http://r.mail.ru/cln2759/go.mail.ru><img src=http://img.mail.ru/mail/ru/images/go-all.gif width=16 height=16 alt="Ïîèñê" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2759/go.mail.ru/>Ïîèñê</a></td>
19 <td width=5%><img src=http://img.mail.ru/0.gif width=7 height=1></td>
20 <td nowrap><a href=http://r.mail.ru/cln2760/love.mail.ru><img src=http://img.mail.ru/mail/ru/images/love-all.gif width=16 height=16 alt="Çíàêîìñòâà" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2760/love.mail.ru>Çíàêîìñòâà</a></td>
21 <td width=5%><img src=http://img.mail.ru/0.gif width=7 height=1></td>
22 <td nowrap><a href=http://r.mail.ru/cln2761/cards.mail.ru><img src=http://img.mail.ru/mail/ru/images/cards-all.gif width=16 height=16 alt="Îòêðûòêè" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2761/cards.mail.ru>Îòêðûòêè</a></td>
23 <td width=5%><img src=http://img.mail.ru/0.gif width=7 height=1></td>
24 <td nowrap><a href=http://r.mail.ru/cln2762/chat.mail.ru><img src=http://img.mail.ru/mail/ru/images/chat-all.gif width=16 height=16 alt="×àòû" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2762/chat.mail.ru>×àòû</a></td>
25 <td width=5%><img src=http://img.mail.ru/0.gif width=7 height=1></td>
26 <td nowrap><a href=http://r.mail.ru/cln2763/content.mail.ru/><img src=http://img.mail.ru/mail/ru/images/content-all.gif width=16 height=16 alt="Ðàññûëêè" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2763/content.mail.ru/>Ðàññûëêè</a></td>
27 <td width=5%><img src=http://img.mail.ru/0.gif width=7 height=1></td>
28 <td nowrap><a href=http://r.mail.ru/cln2764/molotok.ru/><img src=http://img.mail.ru/mail/ru/images/molotok-all.gif width=16 height=16 alt="Ìîëîòîê" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2764/molotok.ru/>Ìîëîòîê</a></td>
29 <td width=5%><img src=http://img.mail.ru/0.gif width=7 height=1></td>
30 <td nowrap><a href=http://r.mail.ru/cln2765/tour.torg.ru/><img src=http://img.mail.ru/mail/ru/images/tour-all.gif width=16 height=16 alt="Ïóòåøåñòâèÿ" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2765/travel.mail.ru/>Ïóòåøåñòâèÿ</a></td>
31 <td width=5%><img src=http://img.mail.ru/0.gif width=7 height=1></td>
32 <td nowrap><a href=http://r.mail.ru/cln2766/auto.mail.ru/><img src=http://img.mail.ru/mail/ru/images/cars-all.gif width=16 height=16 alt="Àâòî" border=0 align=absmiddle></a>&nbsp;<a href=http://r.mail.ru/cln2766/auto.mail.ru/>Àâòî</a></td>
33 <td width=5%><img src=http://img.mail.ru/0.gif width=9 height=1></td>
34 <td nowrap><img src=http://img.mail.ru/0.gif width=16 height=16 border=0 align=absmiddle><a href=http://r.mail.ru/cln2767/mail.ru/all/><b>Âñå ïðîåêòû</b></a></td>
35 <td class=bord_r><img src=http://img.mail.ru/0.gif width=10 height=1></td>
36 </tr><tr>
37 <td colspan=19 class=bord_b width=100% nowrap><img src=http://img.mail.ru/1.gif width=1 height=1></td>
38 </tr></table>
40 <script language="JavaScript"><!--
41 d=document;a='';a+=';r='+escape(d.referrer)
42 js=10
43 //--></script>
44 <script language="JavaScript1.1"><!--
45 a+=';j='+navigator.javaEnabled()
46 js=11
47 //--></script>
48 <script language="JavaScript1.2"><!--
49 s=screen;a+=';s='+s.width+'*'+s.height
50 a+=';d='+(s.colorDepth?s.colorDepth:s.pixelDepth)
51 js=12
52 //--></script>
53 <script language="JavaScript1.3"><!--
54 js=13
55 //--></script>
56 <script language="JavaScript"><!--
57 d.write('<img src="http://top.list.ru/counter'+
58 '?id=575536;js='+js+a+';rand='+Math.random()+
59 '" height=1 width=1><br>')
60 if(js>11)d.write('<'+'!-- ')
61 //--></script>
62 <noscript><img src=http://top.list.ru/counter?js=na;id=575536 height=1 width=1><br></noscript>
63 <script language="JavaScript"><!--
64 if(js>11)d.write('--'+'>')
65 //--></script>
66 <!--/TopList COUNTER-->
67 <a href="http://top100.rambler.ru/top100/"><img src="http://counter.rambler.ru/top100.cnt?716765" alt="Rambler's Top100" width=1 height=1 border=0><br></a>
69 <table cellpadding=0 cellspacing=0 border=0 width=90% align=center>
70 <tr>
71 <td width=100% class=header>
72 <div class=cor><img src=http://img.mail.ru/1.gif width=1 height=1></div>
73 <table cellpadding=0 cellspacing=0 border=0 width=100% height=45>
74 <tr>
75 <td class=head height=44><a href="http://agent.mail.ru/"><img src=http://img.mail.ru/mail/ru/images/agent/agentlogo.gif width=59 height=20 border="0" alt="Àãåíò"></a><a href="http://mail.ru/"><img src=http://img.mail.ru/mail/ru/images/agent/_mail.gif width=104 height=20 border="0" alt=mail.ru></a></td>
76 <td width="00%"><p class=button2><a title="çàãðóçèòü" href="http://agent.mail.ru/magent.exe" class=but>çàãðóçèòü</a></p></td>
77 <td><p class=sog><a href="http://www.mail.ru/pages/help/182.html">Ïîëüçîâàòåëüñêîå<br>ñîãëàøåíèå</a></td>
78 </tr>
79 </table>
80 <img src=http://img.mail.ru/0.gif width=760 height=1><br>
81 <div class=cor><img src=http://img.mail.ru/1.gif width=1 height=1></div>
82 </td>
83 </tr>
84 <tr>
85 <td colspan=3><img src=http://img.mail.ru/0.gif width=1 height=10></td>
86 </tr>
87 </table>
88 <table cellpadding=0 cellspacing=0 border=0 width=90%>
89 <tr>
91 <!-- START: LeftCell -->
92 <td width=23% valign=top>
94 <table cellpadding=0 cellspacing=0 border=0 width=100% class=frame>
95 <tr><td height=1 align=right class=cor><img src=http://img.mail.ru/1.gif width=1 height=1></td></tr>
96 <tr>
97 <td class=cont>
98 <ul class=mmenu>
99 <li><a href="pusk.html">Çàãðóçêà è óñòàíîâêà</a></li>
100 <li><a href="setting.html">Íàñòðîéêà êîíòàêò ëèñòà</a></li>
101 <li><span class=speak>Îáùåíèå</span>
102 <ul type="disc" class="smenu">
103 <li><a href="mess.html">Ïåðåïèñêà</a></li>
104 <li><a href="faq.html">Çâîíêè VoIP</a></li>
105 <li><a href="sms.html">Îòïðàâêà SMS</a></li>
106 <li><a href="chat.html">Îáùåíèå â ÷àòå</a></li>
107 <li><a href="voice.html">Ãîëîñîâîå îáùåíèå</a></li>
108 <li><a href="avatar.html">Îáðàçû</a></li>
109 </ul>
110 </li>
111 <li><a href="notifs.html">Îïîâåùåíèÿ</a></li>
112 <li><a href="games.html">Èãðû</a></li>
113 <li><a href="help.html">×àñòûå âîïðîñû</a></li>
114 <li class="ai">Ðàçðàáîò÷èêàì</a></li><li><a href="http://shop.agent.mail.ru/">Êóïèòü PIN-êîäû</a> <sup>new</sup><ul class="smenu" type="disc"><li><a href="http://shop.agent.mail.ru/faq.php">Óñëîâèÿ è öåíû</a></li></ul>
115 </ul>
116 </td>
117 </tr>
118 <tr><td height=1 align=right class=cor><img src=http://img.mail.ru/1.gif width=1 height=1></td></tr>
119 </table>
121 <img src=http://img.mail.ru/0.gif width=195 height=10><br>
123 </td>
124 <!-- END: LeftCell -->
126 <td width=2%><img src=http://img.mail.ru/0.gif width=10 height=1></td>
128 <!-- START: MainCell -->
129 <td width=75% valign=top class=text>
131 <h1>Îïèñàíèå ïðîòîêîëà</h1>
132 <p>MMP - ïðîòîêîë ñîåäèíåíèÿ Mail.Ru Àãåíòà ñ îáùåé ñåòüþ Mail.Ru. Ðåêîìåíäîâàííûé äëÿ ñîåäèíåíèÿ ñåðâåð â ëþáîé ìîìåíò âðåìåíè ìîæíî ïîëó÷èòü â òåêñòîâîì ôîðìàòå <i>ip:port</i> ïî àäðåñó <b class=blue>mrim.mail.ru:2042</b> è <b class=blue>mrim.mail.ru:443</b>. Âçàèìîäåéñòâèå ñ ñåðâåðîì ïðîèñõîäèò ïîâåðõ ïîñòîÿííî óñòàíîâëåííîãî tcp-ñîåäèíåíèÿ ïîñðåäñòâîì àñèíõðîííîãî îáìåíà êîìàíäàìè. Èíèöèàòîðîì óñòàíîâëåíèÿ ñîåäèíåíèÿ ìîæåò áûòü òîëüêî êëèåíò, êîìàíäû ìîãóò ïîñûëàòüñÿ êàê êëèåíòîì, òàê è ñåðâåðîì.</p>
133 <p>MMP áèíàðíûé ïðîòîêîë. Âñå ÷èñëîâûå äàííûå ïåðåäàþòñÿ êàê ÷åòûðåõáàéòíûå öåëûå ÍÅ â ñåòåâîì ôîðìàòå, ò. å. ïåðâûì èäåò ñòàðøèé áàéò, ïîñëåäíèì ìëàäøèé. ×åòûðåõáàéòîâûå áåççíàêîâûå öåëûå îáîçíà÷àþòñÿ <b>UL</b>.</p>
134 <p>Òåêñòîâûå äàííûå ïåðåäàþòñÿ ñ ïðåôåêñèðîâàííîé äëèíîé, ò. å. ñíà÷àëà <b>UL</b>, à ïîòîì ñòðîêà (â êîäèðîâêå windows-1251) äëèíû <b>UL</b> áåç çàâåðøàþùåãî íóëÿ. Îáîçíà÷åíèå â äàëüíåéøåì - <b>LPS</b>.</p>
135 <p>Òèï äàííûõ <b>UIDL</b> èñïîëüçóåòñÿ òîëüêî ïðè ðàáîòå ñ îñòàâëåííûìè íà ñåðâåðå ñîîáùåíèÿìè. <b>UIDL</b> - ïîñëåäîâàòåëüíîñòü èç 8 ñèìâîëîâ èç ìíîæåñòâà <span class=c>[a-z A-Z 0-9 _ - = +]</span>.</p>
136 <p>Êàæäàÿ êîìàíäà èëè îòâåò íà íåå íà÷èíàþòñÿ ñ çàãîëîâêà. Ïîëÿ óêàçûâàåìûå â çàãîëîâêå:
137 <ul>
138 <li>âîëøåáíûé êëþ÷, óêàçûâàþùèé íà òî, ÷òî ýòî äåéñòâèòåëüíî ïàêåò MMP - âåðñèÿ MMP, ïîääåðæèâàåìàÿ îòïðàâèòåëåì ïàêåòà (òåêóùàÿ âåðñèÿ - 1.7)</li>
139 <li>íîìåð îòïðàâëÿåìîé êîìàíäû â òåêóùåì ñîåäèíåíèè. Îòâåò íà êîìàíäó äîëæåí èìåòü òîò æå íîìåð, ÷òî è ñàìà êîìàíäà.</li>
140 <li>òèï ïàêåòà, íîìåð êîìàíäû è/èëè îòâåòà</li>
141 <li>äëèííà äàííûõ ïàêåòà (áåç ó÷åòà çàãîëîâêà). Ïðè îáðàáîòêå ïîñûëàåìûõ ñåðâåðîì äàííûõ äëèíà ïàêåòà äîëæíà èìåòü ïðèîðèòåò ïåðåä ñïèñêîì åãî ïàðàìåòðîâ, ò. ê. â ñëåäóþùèõ âåðñèÿõ ïðîòîêîëà ìîãóò ïîÿâëÿòüñÿ íîâûå ïàðàìåòðû è âñå îíè áóäóò äîïèñûâàòüñÿ â êîíåö ïàêåòà.</li>
142 <li>ïîðò è ip (â <i>inet_aton()</i> ôîðìàòå) ñ êîòîðûõ óñòàíîâëåíî ñîåäèíåíèå</li>
143 </ul>
144 </p><br>
145 <p>Â ñèíòàêñèñå ÿçûêà Ñ:
146 <pre style="margin-top:8px">
147 Çàãîëîâîê ïàêåòà
149 u_long magic;
150 u_long proto;
151 u_long seq;
152 u_long msg;
153 u_long dlen;
154 u_long from;
155 u_long fromport;
156 u_char reserved[16];
158 </pre>
160 <p>Âàì ïîíàäîáèòñÿ çàãîëîâî÷íûé ôàéë íà ÿçûêå C. Âçÿòü åãî ìîæíî <a href="http://agent.mail.ru/proto.h">çäåñü</a>. </p>
161 <p>Ñïèñîê êîäîâ ãîðîäîâ, íàñåëåííûõ ïóíêòîâ è ðàéîíîâ ìîæíî âçÿòü <a href="http://agent.mail.ru/region.txt">çäåñü.</a></p>
162 <p>&nbsp;</p>
163 <h2>Ïîñëåäîâàòåëüíîñòü êîìàíä</h2>
164 <p>Ïîñëå óñòàíîâêè tcp-ñîåäèíåíèÿ êëèåíò îáÿçàí ñðàçó ïîñëàòü <span class=c>MRIM_CS_HELLO</span>, äîæäàòüñÿ <span class=c>MRIM_CS_HELLO_ACK</span>, ïîñëå ÷åãî îòïðàâèòü <span class=c>MRIM_CS_LOGIN2</span> è íà÷àòü ïîñûëàòü <span class=c>MRIM_CS_PING</span> ñ óñòàíîâëåííûì â <span class=c>MRIM_CS_HELLO_ACK</span> èíòåðâàëîì.  ñëó÷àå óñïåøíîé àâòîðèçàöèè äàëüíåéøèå ïàêåòû (êðîìå <span class=c>MRIM_CS_PING</span>) äîëæíû îòïðàâëÿòüñÿ òîëüêî â ñëó÷àå ïîëüçîâàòåëüñêèõ äåéñòâèé (íàïèñàíèÿ íîâûõ ñîîáùåíèé è ò. ï.) èëè îòâåòà íà ïàêåòû ïîëó÷àåìûå îò ñåðâåðà.</p>
166 <h2 class=pt10>Òèïû ïàêåòîâ</h2>
167 <p class=pack2><u>Òèï ïàêåòà:</u> cs - Client -> Server<br>
168 <u>Òèï ïàêåòà:</u> sc - Server -> Client</p>
170 <h2 class=pt10>Ïàêåòû</h2>
172 <ul class=pack>
173 <li><u>Ïàêåò:</u> <b>Óñòàíîâêà ñîåäèíåíèÿ</b>
174 <p class=pack2>
175 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_HELLO</span><br>
176 <u>Îòâåò:</u> <span class=c>MRIM_CS_HELLO_ACK</span><br>
177 <u>Òèï ïàêåòà:</u> cs<br>
178 <u>Îïèñàíèå:</u> Ïåðâûé ïàêåò, îòïðàâëÿåìûé íà ñåðâåð.
179 </p></li>
180 <li><u>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå óñòàíîâêè ñîåäèíåíèÿ</b>
181 <p class=pack2>
182 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_HELLO_ACK</span><br>
183 <u>Òèï ïàêåòà:</u> sc<br>
184 <u>Ïàðàìåòðû:</u></p>
185 <p class=code>UL ## ping_period ## Îæèäàåìàÿ ÷àñòîòà ïîäòâåðæäåíèÿ ñîåäèíåíèÿ (â ñåêóíäàõ)</p>
186 <p class=pack2>
187 <u>Îïèñàíèå:</u> Ïîäòâåðæäàåò âîçìîæíîñòü ñîåäèíåíèÿ è ñîîáùàåò êëèåíòó èíòåðâàë, ñ êîòîðûì íàäî îòïðàâëÿòü ïàêåòû êîíòðîëÿ ñîåäèíåíèÿ.
188 </p></li>
189 <li><u>Ïàêåò:</u> <b>Óñïåøíàÿ àâòîðèçàöèÿ</b>
190 <p class=pack2>
191 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_LOGIN_ACK</span><br>
192 <u>Òèï ïàêåòà:</u> sc<br>
193 <u>Îïèñàíèå:</u> Ñîîáùàåò, ÷òî ïàðà ëîãèí-ïàðîëü áûëà âåðíà è êëèåíò óñïåøíî àâòîðèçîâàëñÿ â ñåòè àãåíòà.
194 </p></li>
195 <li><u>Ïàêåò:</u> <b>Íåâåðíàÿ àâòîðèçàöèÿ</b>
196 <p class=pack2>
197 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_LOGIN_REJ</span><br>
198 <u>Òèï ïàêåòà:</u> sc<br>
199 <u>Ïàðàìåòðû:</u></p>
200 <p class=code>LPS ## reason ## ïðè÷èíà îòêàçà</p>
201 <p class=pack2>
202 <u>Îïèñàíèå:</u> Ñîîáùàåò, ÷òî ïàðà ëîãèí-ïàðîëü áûëà íåâåðíà, è ñîåäèíåíèå áóäåò çàâåðøåíî.
203 </p></li>
204 <li><u>Ïàêåò:</u> <b>Êîíòðîëü ñîåäèíåíèÿ</b>
205 <p class=pack2>
206 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_PING</span><br>
207 <u>Òèï ïàêåòà:</u> cs<br>
208 <u>Îïèñàíèå:</u> Îòïðàâêà ýòîãî ïàêåòà ïîäòâåðæäàåò äëÿ ñåðâåðà, ÷òî êëèåíò àêòèâåí. Ïàêåò äîëæåí îòïðàâëÿòüñÿ ñ èíòåðâàëîì, îïðåäåëåííûì â <span class=c>MRIM_CS_HELLO_ACK.</span>
209 </p></li>
210 <li><u>Ïàêåò:</u> <b>Ñîîáùåíèå</b>
211 <p class=pack2>
212 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_MESSAGE</span><br>
213 <u>Òèï ïàêåòà:</u> cs<br>
214 ïîëå seq äîëæíî ñîäåðæàòü íîìåð, êîòîðûé â ïîñëåäñòâèè áóäåò ñîäåðæàòüñÿ â çàãîëîâêå ïàêåòà <span class=c>MRIM_CS_MESSAGE_STATUS</span>, îïîâåùàþùåì êëèåíòà î ñòàòóñå äîñòàâêè äàííîãî ñîîáùåíèÿ.<br>
215 <u>Ïàðàìåòðû:</u></p>
216 <p class=code>UL ## flags ## ôëàãè ##</p>
217 <p class=code style="margin-left:20px">MESSAGE_FLAG_OFFLINE ## Ñîîáùåíèå ïðèøëî, ïîêà êëèåíò áûë îòêëþ÷åí<br>
218 MESSAGE_FLAG_NORECV ## Îòïðàâèòåëþ ñîîáùåíèÿ íå òðåáóåòñÿ ïîäòâåðæäåíèÿ äîñòàâêè<br>
219 MESSAGE_FLAG_AUTHORIZE ## Ñîîáùåíèå ÿâëÿåòñÿ çàïðîñîì íà àâòîðèçàöèþ<br>
220 MESSAGE_FLAG_SYSTEM ## Ñîîáùåíèå ÿâëÿåòñÿ ñèñòåìíûì óâåäîìëåíèåì àäìèíèñòðàöèè<br>
221 MESSAGE_FLAG_RTF ##  ñîîáùåíèè ñîäåðæèòñÿ ôîðìàòèðîâàííàÿ ÷àñòü<br>
222 MESSAGE_FLAG_CONTACT ## Ñîîáùåíèå ïðåäñòàâëÿåò èç ñåáÿ ïåðåñëàííûé ñïèñîê êîíòàêòîâ. Òåêñò ñîîáùåíèÿ â ýòîì ñëó÷àå äîëæåí ïðåäñòàâëÿòü èç ñåáÿ ñïèñîê àäðåñîâ è íèêîâ ïåðåñûëàåìûõ êîíòàêòîâ, ïåðå÷èñëåííûõ ÷åðåç òî÷êó ñ çàïÿòîé. <àäðåñ1>;<íèê1>;<àäðåñ2>;<íèê2>;<àäðåñ3>;<íèê3>;...<br>
223 MESSAGE_FLAG_NOTIFY ## Ýòî ñîîáùåíèå-óâåäîìëåíèå "Âàì ïèøóò". Äîëæíî ïîñûëàòüñÿ êàæäûå 10 ñåêóíä, ïðè áîëåå äëèííîé ïàóçå êëèåíò-ïîëó÷àòåëü äîëæåí ñ÷èòàòü, ÷òî îòïðàâèòåëü ïðåêðàòèë íàïèñàíèå. Òåêñò òàêîãî ñîîáùåíèÿ äîëæåí ñîñòîÿòü èç îäíîãî ïðîáåëà.<br>
224 MESSAGE_FLAG_MULTICAST ## Ñîîáùåíèå íàïðàâëåíî ñïèñêó ïîëó÷àòåëåé, à íå îäíîìó. Ïîëå to â òàêîì ñëó÷àå ñîñòîèò èç ñïèñêà ïîëó÷àòåëåé, ïåðå÷èñëåííûõ ÷åðåç çàïÿòóþ. Ìàêñèìàëüíàÿ äëèíà ñïèñêà - 50 àäðåñîâ.</p>
225 <p class=code>
226 LPS ## to ## email ïîëó÷àòåëÿ<br>
227 LPS ## message ## òåêñòîâàÿ âåðñèÿ îòïðàâëÿåìîãî ñîîáùåíèÿ<br>
228 LPS ## rtf-message ## îòôîðìàòèðîâàííàÿ âåðñèÿ îòïðàâëÿåìîãî ñîîáùåíèÿ, â ñëó÷àå íàëè÷èÿ îáîèõ âåðñèé ñîîáùåíèÿ ïðèîðèòåò èìååò rtf-âåðñèÿ. Îíà äîëæíà ñîäåðæàòü rtf-òåêñò óïàêîâàííûé gzip â base64 ïðåäñòàâëåíèè. Òî åñòü:
229 <pre style="margin:0 0 0 10px">
230 BASE64(
231 GZIP(
232 UL êîëè÷åñòâî LPS (äîëæíî áûòü íå ìåíåå 2)
233 LPS rtf_text_with_all_rtf_headers_and_tags
234 LPS öâåò ôîíà â âèäå UL
237 </pre></p>
238 <p class=pack2><u>Îïèñàíèå:</u> Îñíîâíîé ïàêåò âçàèìîäåéñòâèÿ ìåæäó äâóìÿ êëèåíòàìè. Ìîæåò áûòü îòïðàâëåíî â ëþáîé ìîìåíò ïî èíèöèàòèâå êëèåíòà. Íè òåêñòîâàÿ, íè rtf ÷àñòè ñîîáùåíèé íå ìîãóò áûòü ïóñòûìè, ïðè íåîáõîäèìîñòè ñëåäóåò èñïîëüçîâàòü ñòðîêó èç îäíîãî ïðîáåëà.</p>
239 </li>
240 <li><u>Ïàêåò:</u> <b>Äîñòàâêà ñîîáùåíèÿ</b>
241 <p class=pack2>
242 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_MESSAGE_ACK</span><br>
243 <u>Òèï ïàêåòà:</u> sc<br>
244 <u>Ïàðàìåòðû:</u></p>
245 <p class=code>UL ## msg_id ## Íîìåð ïàêåòà (Sequence) ýòîãî ñîîáùåíèÿ äëÿ îòïðàâèòåëÿ<br>
246 UL ## flags ## Âîçìîæíûå çíà÷åíèÿ îïèñàíû â MRIM_CS_MESSAGE<br>
247 LPS ## from ## Àäðåñ îòïðàâèòåëÿ<br>
248 LPS ## message ## òåêñòîâàÿ âåðñèÿ ñîîáùåíèÿ<br>
249 LPS ## rtf-message ## ôîðìàòèðîâàííàÿ âåðñèÿ ñîîáùåíèÿ</p>
250 <p class=pack2>
251 <u>Îïèñàíèå:</u>
252 </p></li>
253 <li><u>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå ïîëó÷åíèÿ ñîîáùåíèÿ</b>
254 <p class=pack2>
255 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_MESSAGE_RECV</span><br>
256 <u>Òèï ïàêåòà:</u> cs<br>
257 <u>Ïàðàìåòðû:</u></p>
258 <p class=code>LPS ## from ##<br>
259 UL ## msg_id ##</p>
260 <p class=pack2>
261 <u>Îïèñàíèå:</u> Îòïðàâëÿåòñÿ ïîëó÷àòåëåì ñîîáùåíèÿ ñðàçó ïîñëå ïðèõîäà <span class=c>MRIM_CS_MESSAGE_ACK</span>, åñëè ôëàãè <span class=c>MRIM_CS_MESSAGE_ACK</span> íå ñîäåðæàëè <span class=c>MESSAGE_FLAG_NORECV</span>. <span class=c>from</span> è <span class=c>msg_id</span> äîëæíû áûòü ñêîïèðîâàíû èç <span class=c>MRIM_CS_MESSAGE_ACK</span> è èìåþò òî æå çíà÷åíèå.
262 </p></li>
263 <li><u>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå äîñòàâêè ñîîáùåíèÿ</b>
264 <p class=pack2>
265 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_MESSAGE_STATUS</span><br>
266 <u>Òèï ïàêåòà:</u> sc<br>
267 Ïîëå seq ÷èñëåííî ðàâíî ïîëþ seq ïàêåòà <span class=c>MRIM_CS_MESSAGE</span><br>
268 <u>Ïàðàìåòðû:</u></p>
269 <p class=code>UL ## status ## ñòàòóñ äîñòàâêè ##</p>
270 <p class=code style="margin-left:20px">MESSAGE_DELIVERED ## Ñîîáùåíèå óñïåøíî äîñòàâëåíî<br>
271 MESSAGE_REJECTED_INTERR ## Ïðîèçîøëà âíóòðåííÿÿ îøèáêà<br>
272 MESSAGE_REJECTED_NOUSER ## Íå ñóùåñòâóåò ïîëüçîâàòåëÿ-ïîëó÷àòåëÿ ñîîáùåíèÿ<br>
273 MESSAGE_REJECTED_LIMIT_EXCEEDED ## Ïîëüçîâàòåëü-ïîëó÷àòåëü â äàííûé ìîìåíò îòêëþ÷åí îò ñåòè, è ñîîáùåíèå íå ïîìåùàåòñÿ â åãî ïî÷òîâûé ÿùèê<br>
274 MESSAGE_REJECTED_TOO_LARGE ## Ðàçìåð ñîîáùåíèÿ ïðåâûøàåò ìàêñèìàëüíî äîïóñòèìûé<br>
275 MESSAGE_REJECTED_DENY_OFFMSG ## Ïîëüçîâàòåëü-ïîëó÷àòåëü â äàííûé ìîìåíò îòêëþ÷åí îò ñåòè, à íàñòðîéêè åãî ïî÷òîâîãî ÿùèêà íå äîïóñêàþò íàëè÷èå îôôëàéíîâûõ ñîîáùåíèé àãåíòà</p>
276 <p class=pack2>
277 <u>Îïèñàíèå:</u> Îòïðàâëåííîå ñîîáùåíèå ñ÷èòàåòñÿ äîñòàâëåííûì òîëüêî ïîñëå ïîëó÷åíèÿ ýòîãî îòâåòà ñåðâåðà. Ñåðâåð ÍÅ ÃÀÐÀÍÒÈÐÓÅÒ äîñòàâêó ñîîáùåíèÿ.  ñëó÷àå îòñòóòñòâèÿ <span class=c>MRIM_CS_MESSAGE_STATUS</span> áîëåå èíòåðâàëà ïîäòâåðæäåíèÿ ñîåäèíåíèÿ, ïðîãðàììà êëèåíò äîëæíà ïîñëàòü ñîîáùåíèå ïîâòîðíî èëè ïðîèíôîðìèðîâàòü ïîëüçîâàòåëÿ î íåâîçìîæíîñòè äîñòàâêè èç-çà ïðîáëåì ñâÿçè ïîëó÷àòåëÿ.
278 </p></li>
279 <li><u>Ïàêåò:</u> <b>Ñìåíà ñòàòóñà äðóãîãî ïîëüçîâàòåëÿ</b>
280 <p class=pack2>
281 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_USER_STATUS</span><br>
282 <u>Òèï ïàêåòà:</u> sc<br>
283 <u>Ïàðàìåòðû:</u></p>
284 <p class=code>UL ## status ## íîâûé ñòàòóñ ïîëüçîâàòåëÿ ##</p>
285 <p class=code style="margin-left:20px">STATUS_OFFLINE ## Ïîëüçîâàòåëü îòêëþ÷åí îò ñåòè Àãåíòà<br>
286 STATUS_ONLINE ## Ïîëüçîâàòåëü íàõîäèòñÿ â ñåòè<br>
287 STATUS_AWAY ## Ïîëüçîâàòåëü â ñåòè, íî îòîøåë îò êîìïüþòåðà<br>
288 STATUS_UNDETERMINATED ## Íàñòðîéêè ïîëüçîâàòåëÿ çàïðåùàþò ïîêàçûâàòü åãî ñòàòóñ<br>
289 STATUS_FLAG_INVISIBLE ## Ïîëüçîâàòåëü íàõîäèòñÿ â ñåòè, íî íåâèäèì äëÿ âñåõ, êðîìå ïðèâèëåãèðîâàííûõ ïîëüçîâàòåëåé èç åãî ñïèñêà âèäèìîñòè.</p>
290 LPS ## user ## email ñìåíèâøåãî ñâîé ñòàòóñ ïîëüçîâàòåëÿ</p>
291 <p class=pack2>
292 <u>Îïèñàíèå:</u> Ýòî ñîîáùåíèå îòïðàâëÿåòñÿ ñåðâåðîì ïðè ñìåíå ñòàòóñà ïîëüçîâàòåëÿì âñåì òåì, ó êîãî îí íàõîäèòñÿ â êîíòàêò-ëèñòå (çà èñêëþ÷åíèåì ãðóïïû "Æäó Àâòîðèçàöèè" è òåõ, êîãî îí âêëþ÷èë â ñïèñîê èãíîðèðóåìûõ èëè íåâèäÿùèõ). Äàííîå ñîîáùåíèå ìîæåò áûòü äîñòàâëåíî êëèåíòó ÄÎ ïîëó÷åíèÿ èì êîíòàêò-ëèñòà.  òàêîé ñèòóàöèè îíî äîëæíî èãíîðèðîâàòüñÿ.
293 </p></li>
294 <li><u>Ïàêåò:</u> <b>Çàêðûòèå ñîåäèíåíèÿ</b>
295 <p class=pack2>
296 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_LOGOUT</span><br>
297 <u>Òèï ïàêåòà:</u> sc<br>
298 <u>Ïàðàìåòðû:</u></p>
299 <p class=code>UL ## reason ## ïðè÷èíà îòêëþ÷åíèÿ ##</p>
300 <p class=code style="margin-left:20px">LOGOUT_NO_RELOGIN_FLAG ## Ïîëüçîâàòåëü îòêëþ÷åí èç-çà ïàðàëëåëüíîãî âõîäà ñ åãî ëîãèíîì. Êëèåíò íå äîëæåí îñóùåñòâëÿòü àâòîìàòè÷åñêèé ïåðåçàõîä â ýòîì ñëó÷àå.</p>
301 </li>
302 <li><u>Ïàêåò:</u> <b>Èçìåíåíèå ïàðàìåòðîâ ñîåäèíåíèÿ</b>
303 <p class=pack2>
304 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_CONNECTION_PARAM</span><br>
305 <u>Òèï ïàêåòà:</u> sc<br>
306 <u>Ïàðàìåòðû:</u></p>
307 <p class=code>UL ## ping_period ## íîâàÿ îæèäàåìàÿ ÷àñòîòà ïîäòâåðæäåíèÿ ñîåäèíåíèÿ</p>
308 <p class=pack2>
309 <u>Îïèñàíèå:</u> Áëèæàéøèé <span class=c>MRIM_CS_PING</span> ñëåäóåò îòïðàâëÿòü óæå èñõîäÿ èç íîâîé ÷àñòîòû.
310 </p></li>
311 <li><u>Ïàêåò:</u> <b>Äîáàâëåíèå íîâîãî êîíòàêòà</b>
312 <p class=pack2>
313 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_ADD_CONTACT</span><br>
314 <u>Òèï ïàêåòà:</u> cs<br>
315 <u>Ïàðàìåòðû:</u></p>
316 <p class=code>UL ## flags ## ôëàãè ##</p>
317 <p class=code style="margin-left:20px">CONTACT_FLAG_GROUP ## Äîáàâëÿåòñÿ íîâàÿ ãðóïïà, à íå êîíòàêò (íåñîâìåñòèì ñ îñòàëüíûìè). Âåðõíèé áàéò ñîäåðæèò êîëè÷åñòâî óæå èìåþùèõñÿ ãðóïï â êîíòàêò-ëèñòå<br>
318 CONTACT_FLAG_INVISIBLE ## Êîíòàêò äîëæåí ïîïàñòü â ñïèñîê "ß âñåãäà íåâèäèì äëÿ"<br>
319 CONTACT_FLAG_VISIBLE ## Êîíòàêò äîëæåí ïîïàñòü â ñïèñîê "ß âñåãäà âèäèì äëÿ"<br>
320 CONTACT_FLAG_IGNORE ## Êîíòàêò äîëæåí ïîïàñòü â ñïèñîê èãíîðèðóåìûõ<br>
321 CONTACT_FLAG_SHADOW ## Êîíòàêò íå äîëæåí ïîïàñòü â îñíîâíîé êîíòàêò-ëèñò (ïðèìåíÿåòñÿ â ïàðå ñ îäíèì èç òðåõ ïðåäûäóùèõ)<br>
322 CONTACT_FLAG_REMOVED ## Êîíòàêò óäàëåí</p>
323 <p class=code>
324 UL ## group_id ## ãðóïïà, â êîòîðóþ äîëæåí áûòü äîáàâëåí êîíòàêò (äëÿ CONTACT_FLAG_GROUP ðàâíî 0)<br>
325 LPS ## email ## äîáàâëÿåìûé àäðåñ (èìÿ ãðóïïû äëÿ CONTACT_FLAG_GROUP)<br>
326 LPS ## name ## íèê äîáàâëÿåìîãî ïîëüçîâàòåëÿ (äëÿ îòîáðàæåíèÿ â êîíòàêò-ëèñòå, íå ïîñûëàåòñÿ äëÿ CONTACT_FLAG_GROUP)
327 LPS ## unused ## íåèñïîëüçóåìûé ïàðàìåòð
328 </p>
329 </li>
330 <li><u>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå äîáàâëåíèÿ êîíòàêòà</b>
331 <p class=pack2>
332 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_ADD_CONTACT_ACK</span><br>
333 <u>Òèï ïàêåòà:</u> sc<br>
334 <u>Ïàðàìåòðû:</u></p>
335 <p class=code>UL ## status ## ðåçóëüòàò îïåðàöèè ##</p>
336 <p class=code style="margin-left:20px">CONTACT_OPER_SUCCESS ## äîáàâëåíèå ïðîèçâåäåíî óñïåøíî<br>
337 CONTACT_OPER_ERROR ## ïåðåäàííûå äàííûå áûëè íåêîððåêòíû<br>
338 CONTACT_OPER_INTERR ## ïðè îáðàáîòêå çàïðîñà ïðîèçîøëà âíóòðåííÿÿ îøèáêà<br>
339 CONTACT_OPER_NO_SUCH_USER ## äîáàâëÿåìîãî ïîëüçîâàòåëÿ íå ñóùåñòâóåò â ñèñòåìå<br>
340 CONTACT_OPER_INVALID_INFO ## íåêîððåêòíîå èìÿ ïîëüçîâàòåëÿ<br>
341 CONTACT_OPER_USER_EXISTS ## ïîëüçîâàòåëü óæå åñòü â êîíòàêò-ëèñòå<br>
342 CONTACT_OPER_GROUP_LIMIT ## ïðåâûøåíî ìàêñèìàëüíî äîïóñòèìîå êîëè÷åñòâî ãðóïï (20)</p>
343 <p class=code>
344 ## UL ## contact_id ## ïðèñâîåííûé íîâîìó êîíòàêòó íîìåð</p>
345 <p class=pack2>
346 <u>Îïèñàíèå:</u> Ïðèõîäèò â îòâåò íà <span class=c>MRIM_CS_ADD_CONTACT</span>. -1 åñëè <span class=c>status</span> íå ðàâåí <span class=c>CONTACT_OPER_SUCCESS</span>.
347 </p></li>
348 <li><u>Ïàêåò:</u> <b>Èçìåíåíèå êîíòàêòà</b>
349 <p class=pack2>
350 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_MODIFY_CONTACT</span><br>
351 <u>Òèï ïàêåòà:</u> cs<br>
352 <u>Ïàðàìåòðû:</u></p>
353 <p class=code>UL ## id ## íîìåð ìîäèôèöèðóåìîãî êîíòàêòà<br>
354 UL ## flags ##<br>
355 UL ## group_id ## Ðàâíî 0 äëÿ ãðóïïû<br>
356 LPS ## contact ## Åñëè ãðóïïà, òî èìÿ ãðóïïû<br>
357 LPS ## name ## Åñëè ãðóïïà, òî èìÿ ãðóïïû</p>
358 <p class=pack2>
359 <u>Îïèñàíèå:</u> Ïàðàìåòðû òå æå, ÷òî è ó <span class=c>MRIM_CS_ADD_CONTACT</span>. <span class=c>contact</span> äî è ïîñëå èçìåíåíèÿ îáÿçàíû ñîâïàäàòü.
360 </p></li>
361 <li><u>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå èçìåíåíèÿ êîíòàêòà</b>
362 <p class=pack2>
363 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_MODIFY_CONTACT_ACK</span><br>
364 <u>Òèï ïàêåòà:</u> sc<br>
365 <u>Ïàðàìåòðû:</u></p>
366 <p class=code>UL ## status ## Ðåçóëüòàò îïåðàöèè. Çíà÷åíèÿ èìåþò òîò æå ñìûñë, ÷òî è â MRIM_CS_ADD_CONTACT_ACK</p>
367 </li>
368 <li><u>Ïàêåò:</u> <b>Ñîîáùåíèå äîñòàâëåííîå, ïîêà ïîëüçîâàòåëü íå áûë ïîäêëþ÷åí ê ñåòè</b>
369 <p class=pack2>
370 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_OFFLINE_MESSAGE_ACK</span><br>
371 <u>Òèï ïàêåòà:</u> sc<br>
372 <u>Ïàðàìåòðû:</u></p>
373 <p class=code>UIDL ## uidl ## id ñîîáùåíèÿ<br>
374 LPS ## message ## ñîîáùåíèå. Ñîîáùåíèå ïðèõîäèò â ôîðìàòå RFC/822 ïèñüìà. Îòïðàâèòåëü ñîîáùåíèÿ õðàíèòñÿ â çàãîëîâêå From, äàòà â çàãîëîâêå Date, ôëàãè ñîîáùåíèÿ â X-MRIM-FLAGS, òåêñòîâàÿ è ôîðìàòèðîâàííàÿ âåðñèè ñîîáùåíèÿ ñîñòàâëÿþò òåêñò ïèñüìà è ðàçäåëÿþòñÿ ìåæäó ñîáîé ðàçäåëèòåëåì èç çàãîëîâêà Boundary.</p>
375 <p class=pack2>
376 <u>Îïèñàíèå:</u> Êàæäîå ïîëó÷åííîå çà âðåìÿ îòñóòñòâèÿ ñîîáùåíèå ïðèõîäèò îòäåëüíûì ïàêåòîì â òîì ïîðÿäêå, â êàêîì îíè ïîñòóïàëè íà ñåðâåð.
377 </p></li>
378 <li><u>Ïàêåò:</u> <b>Óäàëåíèå ñîõðàíåííîãî ñîîáùåíèÿ</b>
379 <p class=pack2>
380 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_OFFLINE_MESSAGE_DEL</span><br>
381 <u>Òèï ïàêåòà:</u> cs<br>
382 <u>Ïàðàìåòðû:</u></p>
383 <p class=code>UIDL ## uidl</p>
384 <p class=pack2>
385 <u>Îïèñàíèå:</u> Íà êàæäûé ïîëó÷åííûé <span class=c>MRIM_CS_OFFLINE_MESSAGE_ACK</span> êëèåíò îáÿçàí îòïðàâèòü <span class=c>MRIM_CS_OFFLINE_MESSAGE_DEL</span> ñ òåì æå <span class=c>uidl</span>, ïîäòâåðæäàþùèé ïîëó÷åíèå äàííîãî ñîîáùåíèÿ. Ñîîáùåíèå ñòèðàåòñÿ íà ñåðâåðå òîëüêî ïðè ïîëó÷åíèè ýòîé êîìàíäû.</p></li>
386 <li><u>Ïàêåò:</u> <b>Àâòîðèçàöèÿ ïîëüçîâàòåëÿ íà äîáàâëåíèå â êîíòàêò-ëèñò</b>
387 <p class=pack2>
388 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_AUTHORIZE</span><br>
389 <u>Òèï ïàêåòà:</u> cs<br>
390 <u>Ïàðàìåòðû:</u></p>
391 <p class=code>LPS ## user ## email ïîëüçîâàòåëÿ</p>
392 <p class=pack2>
393 <u>Îïèñàíèå:</u> Îòïðàâëÿåòñÿ, ÷òîáû ðàçðåøèòü <span class=c>user</span> äîáàâëåíèå ïîëüçîâàòåëÿ â êîíòàêò-ëèñò è íàáëþäåíèå çà åãî ñòàòóñîì.
394 </p></li>
395 <li><u>Ïàêåò:</u> <b>Èíôîðìàöèÿ îá àâòîðèçàöèè</b>
396 <p class=pack2>
397 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_AUTHORIZE_ACK</span><br>
398 <u>Òèï ïàêåòà:</u> sc<br>
399 <u>Ïàðàìåòðû:</u></p>
400 <p class=code>LPS ## user ## email àâòîðèçîâàâøåãî ïîëüçîâàòåëÿ</p>
401 <p class=pack2>
402 <u>Îïèñàíèå:</u> Îòñûëàåòñÿ ñåðâåðîì ïîñëå ïîëó÷åíèåì èì <span class=c>MRIM_CS_AUTHORIZE</span> îò <span class=c>user</span> òîìó, êîãî <span class=c>user</span> àâòîðèçîâàë.
403 </p></li>
404 <li><u>Ïàêåò:</u> <b>Èçìåíåíèå ñòàòóñà</b>
405 <p class=pack2>
406 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_CHANGE_STATUS</span><br>
407 <u>Òèï ïàêåòà:</u> cs<br>
408 <u>Ïàðàìåòðû:</u></p>
409 <p class=code>UL ## status ## âîçìîæíûå çíà÷åíèÿ ñîâïàäàþò ñ MRIM_CS_USER_STATUS, íî íå ìîãóò ïîñûëàòüñÿ ñòàòóñû STATUS_UNDETERMINATED è STATUS_OFFLINE</p>
410 </li>
411 <li><u>Ïàêåò:</u> <b>Òðåáîâàíèå êëþ÷à äëÿ web-àâòîðèçàöèè</b>
412 <p class=pack2>
413 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_GET_MPOP_SESSION</span><br>
414 <u>Òèï ïàêåòà:</u> cs<br>
415 <u>Îïèñàíèå:</u> Ïîëüçîâàòåëü àãåíòà ìîæåò çàõîäèòü â ïî÷òîâûé ÿùèê Mail.Ru áåç äîïîëíèòåëüíîé àâòîðèçàöèè è íå ïåðåäàâàÿ ñâîé ïàðîëü â GET-çàïðîñå, äëÿ ýòîãî èñïîëüçóåòñÿ ìåõàíèçì êëþ÷åé.
416 </p></li>
417 <li><u>Ïàêåò:</u> <b>Êëþ÷ äëÿ web-àâòîðèçàöèè</b>
418 <p class=pack2>
419 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_GET_MPOP_SESSION_ACK</span><br>
420 <u>Òèï ïàêåòà:</u> sc<br>
421 <u>Ïàðàìåòðû:</u></p>
422 <p class=code>UL ## status ## óñïåøíîñòü îïåðàöèè (1 - êëþ÷ ïîëó÷åí, 0 - ïðîèçîøëà îøèáêà)<br>
423 LPS ## session ## ñàì êëþ÷</p>
424 <p class=pack2>
425 <u>Îïèñàíèå:</u> Äëÿ âõîäà â ÿùèê ìîæíî èñïîëüçîâàòü URL win.mail.ru/cgi-bin/auth?Login=email&amp;agent=êëþ÷.
426 </p></li>
427 <li><u>Ïàêåò:</u> <b>Ïîèñê êîíòàêòà</b>
428 <p class=pack2>
429 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_WP_REQUEST</span><br>
430 <u>Òèï ïàêåòà:</u> cs<br>
431 <u>Ïàðàìåòðû:</u></p>
432 <p class=code>UL ## field ## ïàðàìåòð ïîèñêà ##</p>
433 <p class=code style="margin-left:20px">MRIM_CS_WP_REQUEST_PARAM_USER ## ëîãèí (áåç äîìåíà), îáÿçàí êîìáèíèðîâàòüñÿ ñ äîìåíîì<br>
434 MRIM_CS_WP_REQUEST_PARAM_DOMAIN ## ïî÷òîâûé äîìåí<br>
435 MRIM_CS_WP_REQUEST_PARAM_NICKNAME ## íèê<br>
436 MRIM_CS_WP_REQUEST_PARAM_FIRSTNAME ## èìÿ <br>
437 MRIM_CS_WP_REQUEST_PARAM_LASTNAME ## ôàìèëèÿ, * â êîíöå íèêà/èìåíè/ôàìèëèè óêàçûâàåò íà âîçìîæíîñòü ëþáîãî ïðîäîëæåíèÿ èìåíè<br>
438 MRIM_CS_WP_REQUEST_PARAM_SEX ## ïîë. 1 - ìóæñêîé, 2 - æåíñêèé<br>
439 MRIM_CS_WP_REQUEST_PARAM_DATE1 ## ìèíèìàëüíûé âîçðàñò (â ãîäàõ)<br>
440 MRIM_CS_WP_REQUEST_PARAM_DATE2 ## ìàêñèìàëüíûé âîçðàñò (â ãîäàõ)<br>
441 MRIM_CS_WP_REQUEST_PARAM_CITY_ID ## ID ðåãèîíà ïðîæèâàíèÿ <br>
442 MRIM_CS_WP_REQUEST_PARAM_ZODIAC ## Çíàê çîäèàêà (Îâåí - 1, ..., Ðûáû - 12)<br>
443 MRIM_CS_WP_REQUEST_PARAM_BIRTHDAY_MONTH ## Ìåñÿö ðîæäåíèÿ (ßíâàðü - 1, ..., Äåêàáðü - 12)<br>
444 MRIM_CS_WP_REQUEST_PARAM_BIRTHDAY_DAY ## Äåíü ðîæäåíèÿ (îáÿçàí êîìáèíèðîâàòüñÿ ñ ìåñÿöåì ðîæäåíèÿ)<br>
445 MRIM_CS_WP_REQUEST_PARAM_COUNTRY_ID ## ID ñòðàíû ïðîæèâàíèÿ<br>
446 MRIM_CS_WP_REQUEST_PARAM_ONLINE ## èùåì ëè ìû òîëüêî ïîäêëþ÷åííûõ â äàííûé ìîìåíò ïîëüçîâàòåëåé (1)</p>
447 <p class=code>
448 LPS ## value âñå ïàðàìåòðû â ñòðîêîâîì ôîðìàòå, âêëþ÷àÿ ÷èñëà</p>
449 <p class=pack2>
450 <u>Îïèñàíèå:</u> Ïîèñê êîíòàêòîâ â áàçå àãåíòà. Ïàðàìåòðû ïîèñêà ïåðåäàþòñÿ ïàðàìè ïàðàìåòð-çíà÷åíèå. Ïåðåäà÷à íåñêîëüêèõ ïàðàìåòðîâ èìååò ñåìàíòèêó "è", ò. å. âñå íàéäåííûå ðåçóëüòàòû äîëæíû ñîîòâåòñòâîâàòü âñåì ïåðåäàííûì ïàðàìåòðàì. Êîìáèíèðîâàòüñÿ ìîãóò âñå ïàðàìåòðû çà èñêëþ÷åíèåì ëîãèíà è äîìåíà (îíè îáÿçàíû èäòè ïàðîé è íå ìîãóò êîìáèíèðîâàòüñÿ ñ äðóãèìè ïàðàìåòðàìè) â ïîðÿäêå ñîîòâåòñòâóþùåì ïîðÿäêó îïèñàíèÿ (çà èñêëþ÷åíèåì òðåáîâàíèÿ äëÿ <span class=c>MRIM_CS_WP_REQUEST_PARAM_ONLINE</span> áûòü ïîñëåäíèì â ñïèñêå).
451 </p></li>
452 <li><u>Ïàêåò:</u> <b>Íàéäåííûå ïîëüçîâàòåëè</b>
453 <p class=pack2>
454 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_ANKETA_INFO</span><br>
455 <u>Òèï ïàêåòà:</u> cs<br>
456 <u>Ïàðàìåòðû:</u></p>
457 <p class=code>UL ## status ## óñïåøíîñòü çàïðîñà ##</p>
458 <p class=code style="margin-left:20px">MRIM_ANKETA_INFO_STATUS_OK ## ïîèñê óñïåøíî çàâåðøåí<br>
459 MRIM_ANKETA_INFO_STATUS_NOUSER ## íå íàéäåíî íè îäíîé ïîäõîäÿùåé çàïèñè<br>
460 MRIM_ANKETA_INFO_STATUS_RATELIMERR ## ñëèøêîì ìíîãî çàïðîñîâ, ïîèñê âðåìåííî çàïðåùåí</p>
461 <p class=code>
462 UL ## fields_num ## êîëè÷åñòâî ïîëåé â àíêåòå êàæäîãî ïîëüçîâàòåëÿ<br>
463 UL ## max_rows ## òåêóùåå îãðàíè÷åíèå íà êîëè÷åñòâî ðåçóëüòàòîâ ïîèñêà (ìîæåò áûòü áîëüøå, ÷åì êîëè÷åñòâî ñòðîê â äàííîì îòâåòå)<br>
464 UL ## server_time ## òåêóùåå âðåìÿ íà ñåðâåðå (äîëæíî èñïîëüçîâàòüñÿ äëÿ âû÷èñëåíèÿ âîçðàñòà). Ôîðìàò âðåìåíè: Êîëè÷åñòâî ñåêóíä ñ 00:00:00 1 ÿíâàðÿ 1970 ãîäà.<br>
465 LPS, LPS, ... ## fields ## íàçâàíèÿ ïîëåé òåêóùåé àíêåòû (âñåãî fields_num øòóê)<br>
466 LPS, LPS, ... ## values ## çíà÷åíèÿ ïîëåé àíêåòû äëÿ êàæäîãî íàéäåííîãî ïî çàïðîñó ïîëüçîâàòåëÿ â òîì æå ïîðÿäêå, ÷òî â ñïèñêå ïîëåé, ïî fields_num øòóê íà êàæäîãî</p>
467 <p class=pack2>
468 <u>Îïèñàíèå:</u> Ðåçóëüòàò ïîèñêà êîíòàêòîâ. Âîçâðàùàåò àíêåòû íàéäåííûõ ïîëüçîâàòåëåé (èõ àäðåñà ÿâëÿþòñÿ ïîëÿìè àíêåòû).
469 </p></li>
470 <li><u>Ïàêåò:</u> <b>Êîëè÷åñòâî ïèñåì â ïî÷òîâîì ÿùèêå</b>
471 <p class=pack2>
472 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_MAILBOX_STATUS</span><br>
473 <u>Òèï ïàêåòà:</u> sc<br>
474 <u>Ïàðàìåòðû:</u></p>
475 <p class=code>UL ## status ## êîëè÷åñòâî íåïðî÷èòàííûõ ïèñåì</p>
476 <p class=pack2>
477 <u>Îïèñàíèå:</u> Ïðèõîäèò ïðè ïîëó÷åíèè íîâîé ïî÷òû èëè ëþáîì äðóãîì èçìåíåíèè ÷èñëà íåïðî÷èòàííûõ ïèñåì â ÿùèêå.
478 </p></li>
479 <li><u>Ïàêåò:</u> <b>Êîíòàêò-ëèñò</b>
480 <p class=pack2>
481 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_CONTACT_LIST2</span><br>
482 <u>Òèï ïàêåòà:</u> sc<br>
483 <u>Ïàðàìåòðû:</u></p>
484 <p class=code>UL ## status ## ðåçóëüòàò çàïðîñà êîíòàêò-ëèñòà</p>
485 <p class=code style="margin-left:20px">GET_CONTACTS_OK ## ïîèñê âûïîëíåí óñïåøíî<br>
486 GET_CONTACTS_ERROR ## íàéäåííûé êîíòàêò-ëèñò íåêîððåêòåí<br>
487 GET_CONTACTS_INTERR ## ïðîèçîøëà âíóòðåííÿÿ îøèáêà</p>
488 <p class=code>
489 UL ## groups_number ## êîëè÷åñòâî ãðóïï â êîíòàêò-ëèñòå<br>
490 LPS ## group_mask ## ìàñêà-îïèñàíèå ãðóïïû, ñîñòîèò èç ñèìâîëîâ 's' (LPS),'u' (UL),'z' (ñòðîêà îêàí÷èâàþùàÿñÿ áèíàðíûì íóëåì, â äàííûé ìîìåíò íå èñïîëüçóåòñÿ), ñåé÷àñ "us" - ôëàãè è íàçâàíèå, ïðè ðàñøèðåíèè îïèñàíèÿ ñòàðûå ïîëÿ ñîõðàíÿò ñâîå ðàñïîëîæåíèå<br>
491 LPS ## contacts_mask ## ìàñêà-îïèñàíèå ïîëüçîâàòåëÿ (ñèíòàêñèñ òàêîé æå êàê è ó group_mask), ñåé÷àñ uussuu (ôëàãè, ãðóïïà, àäðåñ, íèê, ñåðâåðíûå ôëàãè, òåêóùèé ñòàòóñ â ñåòè)<br>
492 ## groups ## ãðóïïû (âñåãî groups_number øòóê)<br>
493 ## contacts ## êîíòàêòû</p>
494 <p class=pack2>
495 <u>Îïèñàíèå:</u> Êîíòàêò-ëèñò ïîëüçîâàòåëÿ õðàíèòñÿ íà ñåðâåðå. Êëèåíò ìîæåò õðàíèòü ëîêàëüíóþ êîïèþ êîíòàêò-ëèñòà, íî ñåðâåðíàÿ äîëæíà èìåòü ïðèîðèòåò. Ôëàãè êîíòàêòà èìåþò òîò æå ñìûñë, ÷òî â <span class=c>MRIM_CS_ADD_CONTACT</span>, ñòàòóñ - òîò æå ñìûñë, ÷òî â <span class=c>MRIM_CS_USER_STATUS</span>. Ñåðâåðíûé ôëàã â äàííûé ìîìåíò îïðåäåë¸í îäèí - <span class=c>CONTACT_INTFLAG_NOT_AUTHORIZED</span> îçíà÷àåò, ÷òî êîíòàêò åùå íå àâòîðèçîâàë ïîëüçîâàòåëÿ è íàõîäèòñÿ â ãðóïïå "Æäó àâòîðèçàöèè". Åñëè ìàñêà êîíòàêòà èëè ãðóïïû ñîäåðæèò áîëüøå ñèìâîëîâ, ÷åì íåîáõîäèìî, êëèåíò äîëæåí ïðî÷èòàòü çíà÷åíèÿ ýòèõ ïîëåé è ïðîèãíîðèðîâàòü èõ.
496 </p></li>
497 <li><u>Ïàêåò:</u> <b>Èíôîðìàöèÿ î ïîëüçîâàòåëå</b>
498 <p class=pack2>
499 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_USER_INFO</span><br>
500 <u>Òèï ïàêåòà:</u> sc<br>
501 <u>Ïàðàìåòðû:</u></p>
502 <p class=code> LPS, LPS, ... ##name1, value1, name2, value2, ... ## äîïîëíèòåëüíàÿ èíôîðìàöèÿ î ïîëüçîâàòåëå, èìÿ ïàðàìåòðà, çíà÷åíèå ïàðàìåòðà, èìÿ ïàðàìåòðà, çíà÷åíèå ïàðàìåòðà, ... Íà äàííûé ìîìåíò îïðåäåëåíû MESSAGES.TOTAL - êîëè÷åñòâî ïèñåì â ÿùèêå, MESSAGES.UNREAD - êîëè÷åñòâî íåïðî÷èòàííûõ ïèñåì â ÿùèêå, MRIM.NICKNAME - íèê ïîëüçîâàòåëÿ
503 </p></li>
504 <li><u>Ïàêåò:</u> <b>Àâòîðèçàöèÿ</b>
505 <p class=pack2>
506 <u>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_LOGIN2</span><br>
507 <u>Òèï ïàêåòà:</u> cs<br>
508 <u>Ïàðàìåòðû:</u></p>
509 <p class=code>LPS ## login ## email àâòîðèçóþùåãîñÿ ïîëüçîâàòåëÿ<br>
510 LPS ## password ## ïàðîëü<br>
511 UL ## status ## ñòàòóñ (ñì. MRIM_CS_CHANGE_STATUS)<br>
512 LPS ## user_agent ## òåêñòîâîå îïèñàíèå êëèåíòà ïîëüçîâàòåëÿ, íàïðèìåð "Mail.Ru Miranda Plugin v 1.0" </p>
513 </li>
514 </ul>
516 <img src=http://img.mail.ru/0.gif width=555 height=10><br>
517 </td>
518 <!-- END: MainCell -->
520 </tr>
521 </table>
523 <table cellpadding=0 cellspacing=0 border=0 width=90% align=center>
524 <tr>
525 <td width=100% align=center>
526 <div class=plash>
527 <div class=cor><img src=http://img.mail.ru/1.gif width=1 height=1></div>
528 <table cellpadding=0 cellspacing=0 border=0 width=96% class=footer>
529 <tr>
530 <td width=27% height=20>&copy; 1999-2006, <a href=http://www.mail.ru target=_blank>Mail.Ru</a></td>
531 <td align=center width=37% ><a href=http://win.mail.ru/cgi-bin/support_mra?version=www target=_blank>Ñëóæáà ïîääåðæêè</a></td>
532 <td width=30% height=20 align=right><a href=http://sales.mail.ru/>Ðåêëàìà íà Mail.ru</a> <b>&middot;</b> <a href=http://corp.mail.ru/>Î êîìïàíèè</a></td>
533 </tr>
534 </table>
535 <img src=http://img.mail.ru/0.gif width=760 height=1><br>
536 <div class=cor><img src=http://img.mail.ru/1.gif width=1 height=1></div>
537 </div>
538 </td>
539 </tr>
540 </table>
541 <br style="line-height:30px;">
542 </center>
543 </body>
544 </html>