1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN">
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">
13 <body bgcolor=white leftmargin=
0 rightmargin=
0 topmargin=
0 bottommargin=
0 marginheight=
0 marginwidth=
0>
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> <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> <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> <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> <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> <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> <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> <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> <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>
37 <td colspan=
19 class=bord_b width=
100% nowrap
><img src=http://img.mail.ru/
1.gif width=
1 height=
1></td>
40 <script language=
"JavaScript"><!--
41 d
=document
;a
='';a
+=';r='+escape(d
.referrer
)
44 <script language
="JavaScript1.1"><!--
45 a
+=';j='+navigator
.javaEnabled()
48 <script language
="JavaScript1.2"><!--
49 s
=screen
;a
+=';s='+s
.width
+'*'+s
.height
50 a
+=';d='+(s
.colorDepth
?s
.colorDepth
:s
.pixelDepth
)
53 <script language
="JavaScript1.3"><!--
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('<'+'!-- ')
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('--'+'>')
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
>
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>
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
>
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>
85 <td colspan
=3><img src
=http
://img.mail.ru/0.gif width=1 height=10></td>
88 <table cellpadding
=0 cellspacing
=0 border
=0 width
=90%>
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>
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>
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
>
118 <tr
><td height
=1 align
=right
class=cor
><img src
=http
://img.mail.ru/1.gif width=1 height=1></td></tr>
121 <img src
=http
://img.mail.ru/0.gif width=195 height=10><br>
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
>Êàæäàÿ êîìàíäà èëè îòâåò íà íåå íà÷èíàþòñÿ ñ çàãîëîâêà. Ïîëÿ óêàçûâàåìûå â çàãîëîâêå:
138 <li
>âîëøåáíûé êëþ÷, óêàçûâàþùèé íà òî, ÷òî ýòî äåéñòâèòåëüíî ïàêåò MMP
- âåðñèÿ MMP
, ïîääåðæèâàåìàÿ îòïðàâèòåëåì ïàêåòà (òåêóùàÿ âåðñèÿ - 1.7)</li
>
139 <li
>íîìåð îòïðàâëÿåìîé êîìàíäû â òåêóùåì ñîåäèíåíèè. Îòâåò íà êîìàíäó äîëæåí èìåòü òîò æå íîìåð, ÷òî è ñàìà êîìàíäà.</li
>
140 <li
>òèï ïàêåòà, íîìåð êîìàíäû è/èëè îòâåòà</li>
141 <li
>äëèííà äàííûõ ïàêåòà (áåç ó÷åòà çàãîëîâêà). Ïðè îáðàáîòêå ïîñûëàåìûõ ñåðâåðîì äàííûõ äëèíà ïàêåòà äîëæíà èìåòü ïðèîðèòåò ïåðåä ñïèñêîì åãî ïàðàìåòðîâ, ò. ê. â ñëåäóþùèõ âåðñèÿõ ïðîòîêîëà ìîãóò ïîÿâëÿòüñÿ íîâûå ïàðàìåòðû è âñå îíè áóäóò äîïèñûâàòüñÿ â êîíåö ïàêåòà.</li
>
142 <li
>ïîðò è ip (â <i
>inet_aton()</i> ôîðìàòå) ñ êîòîðûõ óñòàíîâëåíî ñîåäèíåíèå</li>
145 <p
>Â ñèíòàêñèñå ÿçûêà Ñ:
146 <pre style
="margin-top:8px">
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>
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
>
173 <li
><u
>Ïàêåò:</u> <b>Óñòàíîâêà ñîåäèíåíèÿ</b
>
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
> Ïåðâûé ïàêåò, îòïðàâëÿåìûé íà ñåðâåð.
180 <li
><u
>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå óñòàíîâêè ñîåäèíåíèÿ</b
>
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
>
187 <u
>Îïèñàíèå:</u
> Ïîäòâåðæäàåò âîçìîæíîñòü ñîåäèíåíèÿ è ñîîáùàåò êëèåíòó èíòåðâàë, ñ êîòîðûì íàäî îòïðàâëÿòü ïàêåòû êîíòðîëÿ ñîåäèíåíèÿ.
189 <li
><u
>Ïàêåò:</u> <b>Óñïåøíàÿ àâòîðèçàöèÿ</b
>
191 <u
>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_LOGIN_ACK</span><br
>
192 <u
>Òèï ïàêåòà:</u
> sc
<br
>
193 <u
>Îïèñàíèå:</u
> Ñîîáùàåò, ÷òî ïàðà ëîãèí-ïàðîëü áûëà âåðíà è êëèåíò óñïåøíî àâòîðèçîâàëñÿ â ñåòè àãåíòà.
195 <li
><u
>Ïàêåò:</u> <b>Íåâåðíàÿ àâòîðèçàöèÿ</b
>
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
>
202 <u
>Îïèñàíèå:</u
> Ñîîáùàåò, ÷òî ïàðà ëîãèí-ïàðîëü áûëà íåâåðíà, è ñîåäèíåíèå áóäåò çàâåðøåíî.
204 <li
><u
>Ïàêåò:</u> <b>Êîíòðîëü ñîåäèíåíèÿ</b
>
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>
210 <li
><u
>Ïàêåò:</u> <b>Ñîîáùåíèå</b
>
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
>
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">
232 UL
êîëè÷åñòâî LPS (äîëæíî áûòü íå ìåíåå 2)
233 LPS rtf_text_with_all_rtf_headers_and_tags
234 LPS
öâåò ôîíà â âèäå UL
238 <p
class=pack2
><u
>Îïèñàíèå:</u> Îñíîâíîé ïàêåò âçàèìîäåéñòâèÿ ìåæäó äâóìÿ êëèåíòàìè. Ìîæåò áûòü îòïðàâëåíî â ëþáîé ìîìåíò ïî èíèöèàòèâå êëèåíòà. Íè òåêñòîâàÿ, íè rtf ÷àñòè ñîîáùåíèé íå ìîãóò áûòü ïóñòûìè, ïðè íåîáõîäèìîñòè ñëåäóåò èñïîëüçîâàòü ñòðîêó èç îäíîãî ïðîáåëà.</p>
240 <li
><u
>Ïàêåò:</u> <b>Äîñòàâêà ñîîáùåíèÿ</b
>
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
>
253 <li
><u
>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå ïîëó÷åíèÿ ñîîáùåíèÿ</b
>
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
>
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
> è èìåþò òî æå çíà÷åíèå.
263 <li
><u
>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå äîñòàâêè ñîîáùåíèÿ</b
>
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
>
277 <u
>Îïèñàíèå:</u> Îòïðàâëåííîå ñîîáùåíèå ñ÷èòàåòñÿ äîñòàâëåííûì òîëüêî ïîñëå ïîëó÷åíèÿ ýòîãî îòâåòà ñåðâåðà. Ñåðâåð ÍÅ ÃÀÐÀÍÒÈÐÓÅÒ äîñòàâêó ñîîáùåíèÿ.  ñëó÷àå îòñòóòñòâèÿ <span class=c>MRIM_CS_MESSAGE_STATUS</span> áîëåå èíòåðâàëà ïîäòâåðæäåíèÿ ñîåäèíåíèÿ, ïðîãðàììà êëèåíò äîëæíà ïîñëàòü ñîîáùåíèå ïîâòîðíî èëè ïðîèíôîðìèðîâàòü ïîëüçîâàòåëÿ î íåâîçìîæíîñòè äîñòàâêè èç-çà ïðîáëåì ñâÿçè ïîëó÷àòåëÿ.
279 <li
><u
>Ïàêåò:</u> <b>Ñìåíà ñòàòóñà äðóãîãî ïîëüçîâàòåëÿ</b
>
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
>
292 <u
>Îïèñàíèå:</u
> Ýòî ñîîáùåíèå îòïðàâëÿåòñÿ ñåðâåðîì ïðè ñìåíå ñòàòóñà ïîëüçîâàòåëÿì âñåì òåì, ó êîãî îí íàõîäèòñÿ â êîíòàêò-ëèñòå (çà èñêëþ÷åíèåì ãðóïïû "Æäó Àâòîðèçàöèè" è òåõ, êîãî îí âêëþ÷èë â ñïèñîê èãíîðèðóåìûõ èëè íåâèäÿùèõ). Äàííîå ñîîáùåíèå ìîæåò áûòü äîñòàâëåíî êëèåíòó ÄÎ ïîëó÷åíèÿ èì êîíòàêò-ëèñòà.  òàêîé ñèòóàöèè îíî äîëæíî èãíîðèðîâàòüñÿ.
294 <li
><u
>Ïàêåò:</u> <b>Çàêðûòèå ñîåäèíåíèÿ</b
>
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
>
302 <li
><u
>Ïàêåò:</u> <b>Èçìåíåíèå ïàðàìåòðîâ ñîåäèíåíèÿ</b
>
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
>
309 <u
>Îïèñàíèå:</u> Áëèæàéøèé <span class=c>MRIM_CS_PING</span> ñëåäóåò îòïðàâëÿòü óæå èñõîäÿ èç íîâîé ÷àñòîòû.
311 <li
><u
>Ïàêåò:</u> <b>Äîáàâëåíèå íîâîãî êîíòàêòà</b
>
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
>
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
## íåèñïîëüçóåìûé ïàðàìåòð
330 <li
><u
>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå äîáàâëåíèÿ êîíòàêòà</b
>
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
>
344 ## UL
## contact_id
## ïðèñâîåííûé íîâîìó êîíòàêòó íîìåð</p
>
346 <u
>Îïèñàíèå:</u> Ïðèõîäèò â îòâåò íà <span class=c>MRIM_CS_ADD_CONTACT</span>. -1 åñëè <span
class=c
>status
</span> íå ðàâåí <span class=c>CONTACT_OPER_SUCCESS</span>.
348 <li
><u
>Ïàêåò:</u> <b>Èçìåíåíèå êîíòàêòà</b
>
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
>
355 UL
## group_id
## Ðàâíî 0 äëÿ ãðóïïû<br
>
356 LPS
## contact
## Åñëè ãðóïïà, òî èìÿ ãðóïïû<br
>
357 LPS
## name
## Åñëè ãðóïïà, òî èìÿ ãðóïïû</p
>
359 <u
>Îïèñàíèå:</u> Ïàðàìåòðû òå æå, ÷òî è ó <span class=c>MRIM_CS_ADD_CONTACT</span>. <span
class=c
>contact
</span
> äî è ïîñëå èçìåíåíèÿ îáÿçàíû ñîâïàäàòü.
361 <li
><u
>Ïàêåò:</u> <b>Ïîäòâåðæäåíèå èçìåíåíèÿ êîíòàêòà</b
>
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
>
368 <li
><u
>Ïàêåò:</u> <b>Ñîîáùåíèå äîñòàâëåííîå, ïîêà ïîëüçîâàòåëü íå áûë ïîäêëþ÷åí ê ñåòè</b
>
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>
376 <u
>Îïèñàíèå:</u
> Êàæäîå ïîëó÷åííîå çà âðåìÿ îòñóòñòâèÿ ñîîáùåíèå ïðèõîäèò îòäåëüíûì ïàêåòîì â òîì ïîðÿäêå, â êàêîì îíè ïîñòóïàëè íà ñåðâåð.
378 <li
><u
>Ïàêåò:</u> <b>Óäàëåíèå ñîõðàíåííîãî ñîîáùåíèÿ</b
>
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
>
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
>
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
>
393 <u
>Îïèñàíèå:</u> Îòïðàâëÿåòñÿ, ÷òîáû ðàçðåøèòü <span class=c>user</span> äîáàâëåíèå ïîëüçîâàòåëÿ â êîíòàêò-ëèñò è íàáëþäåíèå çà åãî ñòàòóñîì.
395 <li
><u
>Ïàêåò:</u> <b>Èíôîðìàöèÿ îá àâòîðèçàöèè</b
>
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
>
402 <u
>Îïèñàíèå:</u> Îòñûëàåòñÿ ñåðâåðîì ïîñëå ïîëó÷åíèåì èì <span class=c>MRIM_CS_AUTHORIZE</span> îò <span
class=c
>user
</span> òîìó, êîãî <span class=c>user</span> àâòîðèçîâàë.
404 <li
><u
>Ïàêåò:</u> <b>Èçìåíåíèå ñòàòóñà</b
>
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
>
411 <li
><u
>Ïàêåò:</u> <b>Òðåáîâàíèå êëþ÷à äëÿ web-àâòîðèçàöèè</b
>
413 <u
>Èìÿ ïàêåòà:</u> <span class=c>MRIM_CS_GET_MPOP_SESSION</span><br
>
414 <u
>Òèï ïàêåòà:</u
> cs
<br
>
415 <u
>Îïèñàíèå:</u
> Ïîëüçîâàòåëü àãåíòà ìîæåò çàõîäèòü â ïî÷òîâûé ÿùèê Mail
.Ru
áåç äîïîëíèòåëüíîé àâòîðèçàöèè è íå ïåðåäàâàÿ ñâîé ïàðîëü â GET
-çàïðîñå, äëÿ ýòîãî èñïîëüçóåòñÿ ìåõàíèçì êëþ÷åé.
417 <li
><u
>Ïàêåò:</u> <b>Êëþ÷ äëÿ web-àâòîðèçàöèè</b
>
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
>
425 <u
>Îïèñàíèå:</u> Äëÿ âõîäà â ÿùèê ìîæíî èñïîëüçîâàòü URL win.mail.ru/cgi-bin
/auth
?Login
=email
&
;agent
=êëþ÷.
427 <li
><u
>Ïàêåò:</u> <b>Ïîèñê êîíòàêòà</b
>
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
>
448 LPS
## value
âñå ïàðàìåòðû â ñòðîêîâîì ôîðìàòå, âêëþ÷àÿ ÷èñëà</p
>
450 <u
>Îïèñàíèå:</u> Ïîèñê êîíòàêòîâ â áàçå àãåíòà. Ïàðàìåòðû ïîèñêà ïåðåäàþòñÿ ïàðàìè ïàðàìåòð-çíà÷åíèå. Ïåðåäà÷à íåñêîëüêèõ ïàðàìåòðîâ èìååò ñåìàíòèêó "è", ò. å. âñå íàéäåííûå ðåçóëüòàòû äîëæíû ñîîòâåòñòâîâàòü âñåì ïåðåäàííûì ïàðàìåòðàì. Êîìáèíèðîâàòüñÿ ìîãóò âñå ïàðàìåòðû çà èñêëþ÷åíèåì ëîãèíà è äîìåíà (îíè îáÿçàíû èäòè ïàðîé è íå ìîãóò êîìáèíèðîâàòüñÿ ñ äðóãèìè ïàðàìåòðàìè) â ïîðÿäêå ñîîòâåòñòâóþùåì ïîðÿäêó îïèñàíèÿ (çà èñêëþ÷åíèåì òðåáîâàíèÿ äëÿ <span class=c>MRIM_CS_WP_REQUEST_PARAM_ONLINE</span> áûòü ïîñëåäíèì â ñïèñêå).
452 <li
><u
>Ïàêåò:</u> <b>Íàéäåííûå ïîëüçîâàòåëè</b
>
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
>
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
>
468 <u
>Îïèñàíèå:</u
> Ðåçóëüòàò ïîèñêà êîíòàêòîâ. Âîçâðàùàåò àíêåòû íàéäåííûõ ïîëüçîâàòåëåé (èõ àäðåñà ÿâëÿþòñÿ ïîëÿìè àíêåòû).
470 <li
><u
>Ïàêåò:</u> <b>Êîëè÷åñòâî ïèñåì â ïî÷òîâîì ÿùèêå</b
>
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
>
477 <u
>Îïèñàíèå:</u
> Ïðèõîäèò ïðè ïîëó÷åíèè íîâîé ïî÷òû èëè ëþáîì äðóãîì èçìåíåíèè ÷èñëà íåïðî÷èòàííûõ ïèñåì â ÿùèêå.
479 <li
><u
>Ïàêåò:</u> <b>Êîíòàêò-ëèñò</b
>
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
>
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
>
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> îçíà÷àåò, ÷òî êîíòàêò åùå íå àâòîðèçîâàë ïîëüçîâàòåëÿ è íàõîäèòñÿ â ãðóïïå "Æäó àâòîðèçàöèè". Åñëè ìàñêà êîíòàêòà èëè ãðóïïû ñîäåðæèò áîëüøå ñèìâîëîâ, ÷åì íåîáõîäèìî, êëèåíò äîëæåí ïðî÷èòàòü çíà÷åíèÿ ýòèõ ïîëåé è ïðîèãíîðèðîâàòü èõ.
497 <li
><u
>Ïàêåò:</u> <b>Èíôîðìàöèÿ î ïîëüçîâàòåëå</b
>
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
- íèê ïîëüçîâàòåëÿ
504 <li
><u
>Ïàêåò:</u> <b>Àâòîðèçàöèÿ</b
>
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
>
516 <img src
=http
://img.mail.ru/0.gif width=555 height=10><br>
518 <!-- END
: MainCell
-->
523 <table cellpadding
=0 cellspacing
=0 border
=0 width
=90% align
=center
>
525 <td width
=100% align
=center
>
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
>
530 <td width
=27% height
=20>©
; 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>·</b> <a href=http://corp.mail.ru/>Î êîìïàíèè</a></td>
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>
541 <br style
="line-height:30px;">