yellows111
/
msnp-wiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
msnp-wiki/docs/commands/not.md

129 lines
4.0 KiB
Markdown
Raw Permalink Normal View History

massive amount of corrections, rest of pre-P11 commands upgrade yiki, slugs now work better, but not in URLs (i forgot) 0 Commands Left. Time for that parity check. Add a license too. Bump version to 0.1.0. NEW RECORD!
2024-10-26 06:56:17 -04:00
# Introduction
`NOT` is a command introduced with [MSNP5](../versions/msnp5.md).
It is a Notification Server command, WITH a response payload.
Used to send notifications ("alerts") to the client.
# Client/Request
This command can not be sent from the client.
# Server/Response
```
NOT length
payload
```
Where `length` is the size (in bytes) of the `payload`.
Where `payload` is a [`<NOTIFICATION>` document](../files/notification.md).
# Examples
## Basic notification
```
S: NOT 367
<NOTIFICATION ver="1" id="2" siteid="0" siteurl="http://example.com/">
<TO pid="0x00000001:0x00000002" name="example@hotmail.com" />
<MSG id="0">
<ACTION url="alert?command=action" />
<SUBSCR url="alert?command=change" />
<BODY lang="1033" icon="alerticon_32x32.png">
<TEXT>This is an example notification.</TEXT>
</BODY>
</MSG>
</NOTIFICATION>
```
## Advanced notification
*Since [MSNP9](../versions/msnp9.md).*
```
S: NOT 457
<NOTIFICATION ver="1" id="2" siteid="0" siteurl="http://example.com/">
<TO pid="0x00000001:0x00000002" name="example@hotmail.com" />
<MSG id="0">
<ACTION url="alert?command=action" />
<SUBSCR url="alert?command=change" />
<BODY lang="1033" icon="alerticon_32x32.png">
<TEXT>This is an example notification.</TEXT>
<TEXTX>&lt;P&gt;This is an &lt;B&gt;extended&lt;/B&gt; notification!&lt;/P&gt</TEXTX>
</BODY>
</MSG>
</NOTIFICATION>
```
## Blog update notification
*Since [MSNP11](../versions/msnp11.md).*
```
S: NOT 1249
<NOTIFICATION id="2" siteid="45705" siteurl="http://storage.msn.com/">
<TO pid="0x00000001:0x00000002" name="example@hotmail.com">
<VIA agent="messenger"/>
</TO>
<MSG id="0">
<ACTION url="a.htm" />
<SUBSCR url="s.htm" />
<BODY>
&lt;NotificationData xmlns:xsd=&quot;http://www.w3.org/2001/XMLSchema&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;&gt;
&lt;SpaceHandle&gt;
&lt;ResourceID&gt;example1!101&lt;/ResourceID&gt;
&lt;/SpaceHandle&gt;
&lt;ComponentHandle&gt;
&lt;ResourceID&gt;example2!101&lt;/ResourceID&gt;
&lt;/ComponentHandle&gt;
&lt;OwnerCID&gt;4294967298&lt;/OwnerCID&gt;
&lt;LastModifiedDate&gt;2024-10-26T09:33:27.1020000-08:00&lt;/LastModifiedDate&gt;
&lt;HasNewItem&gt;true&lt;HasNewItem&gt;
&lt;ComponentSummary&gt;
&lt;Component xsi:type=&quot;MessageContainer&quot;&gt;
&lt;ResourceID&gt;example2!102&lt;/ResourceID&gt;
&lt;/Component&gt;
&lt;Items&gt;
&lt;Component xsi:type=&quot;Message&quot;&gt;
&lt;ResourceID&gt;example2!101&lt;/ResourceID&gt;
&lt;/Component&gt;
&lt;/Items&gt;
&lt;/ComponentSummary&gt;
&lt;/NotificationData&gt;
</BODY>
</MSG>
</NOTIFICATION>
```
## Contact update notification
*Since [MSNP13](../versions/msnp13.md).*
```
S: NOT 685
<NOTIFICATION id="2" siteid="45705" siteurl="http://contacts.msn.com/">
<TO pid="0x00000001:0x00000002" name="example@hotmail.com">
<VIA agent="messenger"/>
</TO>
<MSG id="0">
<ACTION url="a.htm" />
<SUBSCR url="s.htm" />
<BODY>
&lt;NotificationData xmlns:xsd=&quot;http://www.w3.org/2001/XMLSchema&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;&gt;
&lt;Service&gt;ABCHInternal&lt;/Service&gt;
&lt;CID&gt;4294967298&lt;/CID&gt;
&lt;LastModifiedDate&gt;2024-10-26T09:33:27.1020000-08:00&lt;/LastModifiedDate&gt;
&lt;HasNewItem&gt;false&lt;/HasNewItem&gt;
&lt;/NotificationData&gt;
</BODY>
</MSG>
</NOTIFICATION>
```
## Invalid context
[0.1.1] corrections, added UUX, UBX alright i'll say that's pretty good. Testing the new versioning system. Each update to the wiki now has it's own patch version bump, for tracking. also i probably should of actually looked at what P11 does for UUX before writing that...
2024-10-28 08:20:47 -04:00
*Inherited from being an unimplemented command.*
massive amount of corrections, rest of pre-P11 commands upgrade yiki, slugs now work better, but not in URLs (i forgot) 0 Commands Left. Time for that parity check. Add a license too. Bump version to 0.1.0. NEW RECORD!
2024-10-26 06:56:17 -04:00
```
C: NOT 1 0
```
Server disconnects client.
# Known changes
* [MSNP11](../versions/msnp11.md): Using an `<NotificationData>` sub-document embedded into a `<NOTIFICATION>` document is supported.
Using the new sub-document, live blog updates are now sent.
* [MSNP13](../versions/msnp13.md): Used for [Address Book Service](../services/abservice.md) live updates using the `<NotificationData>` sub-document.
* [MSNP18](../versions/msnp18.md): Used for live persistant chat group ("circle") updates using the `<NotificationData>` sub-document.