msnp-wiki/docs/versions/msnp5.md

4.3 KiB

Introduction

MSNP5 is the fourth released version of the Mobile Status Notification Protocol. It was introduced officially in Client Version 3.0.0283.

Command information

It introduces the notification service commands:

No switchboard or dispatch service commands were known to be introduced in this version

It introduces the error codes:

  • 922

No commands were known to be removed in this version

Known changes

(from MSNP4):

  • BPR and PRP have been added to SYN.
  • Non-protocol: Official website stopped updating the whatsnew.asp page between this (MSNP5) and MSNP7.
  • Official Client: Introduced the toast notification system. Notifications can now stack vertically.
  • Official Client: Log in notifications are now handled by the newly introduced toast system.
  • Official Client: Introduced emoticons.
  • Official Client: Introduced File Transfer and Messenger-to-Messenger calling via invitations.
  • Introduced first payload commands (SDC, PAG) to be sent to the Notification Server from the client.
  • Official Client: FND functionality changed slightly(?) to say that Passport doesn't allow users to retrieve the e-mails assocated with the user's account, sending the user to a invitation screen with, with it ending in sending an SDC in the format of SDC TrID {FND index} 0x0409 MSMSGS MSMSGS X X example%20user {length}. The 0x0409 can be changed to any language code, with the length denoting the payload if specified.
  • Official Client: URL without the Passport Site ID (parameter 3) support has been removed.
  • Official Client: Added new URL services MOBILE and CHGMOB .
  • Official Client: Error code 924 has been shadow-implemented, which when sent as a USR response, shows the "Sorry, you can not sign in until your verify that (user handle) really belongs to you" dialog.

Changes to error codes

Only applies for the Official Client.

Re-added

Where the parenthesis are the last version that had the error.

Removed

  • 131
  • 209
  • 212
  • 500
  • 501
  • 912
  • 913

Client-server communication example

C: VER 1 MSNP5 MSNP4 CVR0
S: VER 1 MSNP5
C: INF 2
S: INF 2 MD5
C: USR 3 MD5 I example@hotmail.com
S: XFR 3 NS 10.0.0.5:1863 0

Client disconnects from server

Client opens a connection to 10.0.0.5:1863

C: VER 4 MSNP5 MSNP4 CVR0
S: VER 4 MSNP5
C: INF 5
S: INF 5 MD5
C: USR 6 MD5 I example@hotmail.com
S: USR 6 MDS S prefix
C: USR 7 MD5 S $md5(prefix + password)
S: USR 7 OK example@hotmail.com example%20user
S: MSG Hotmail Hotmail 367
MIME-Version: 1.0
Content-Type: text/x-msmsgsprofile; charset=UTF-8
LoginTime: 1726321960
EmailEnabled: 1
MemberIdHigh: 1
MemberIdLow: 2
lang_preference: 1033
PreferredEmail: example@hotmail.com
country: US
PostalCode: 
Gender: 
Kid: 0
Age: 
BDayPre: 
Birthday: 
Wallet: 
Flags: 1027
sid: 507
kv: 11
MSPAuth: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA$$

C: SYN 8 5
S: SYN 8 6
S: SYN 8 6
S: GTC 8 6 A
S: BLP 8 6 AL
S: LST 8 FL 6 1 1 anotheruser@hotmail.com another%20user
S: BPR 6 anotheruser@hotmail.com PHH 1%20(222)%203333
S: BPR 6 anotheruser@hotmail.com PHW
S: BPR 6 anotheruser@hotmail.com PHM
S: BPR 6 anotheruser@hotmail.com MOB N
S: LST 8 AL 6 1 1 anotheruser@hotmail.com another%20user
S: LST 8 BL 6 0 0
S: LST 8 RL 6 1 1 anotheruser@hotmail.com another%20user
C: CHG 9 NLN
S: CHG 9 NLN
S: NOT 431
<NOTIFICATION ver="1" siteid="111100000" siteurl="http://example.com" id="0">
<TO pid="0x00000001:0x00000002" name="example@hotmail.com" />
<MSG pri="" id="0">
<ACTION url="/messenger/action?reference=something1"/>
<SUBSCR url="/messenger/changealerts?reference=something1"/>
<CAT id="111100001" />
<BODY lang="1033" icon="/messenger/icon_32x32.png">
<TEXT>text of the notification</TEXT>
</BODY>
</MSG>
</NOTIFICATION>
C: PRP 10 PHH 123%20(4567)
S: PRP 10 7 PHH 123%20(4567)
S: BPR 8 anotheruser@hotmail.com PHH 1%20(222)%20333%204444
C: OUT

Client disconnects from server

S: OUT

Server disconnects client