3.9 KiB
Introduction
URL
is a command introduced with MSNP2.
It is a Notification Server command, without a request or response payload.
It retrieves a service URL to open.
Client/Request
URL TrID service {param}
Where service
is the specified service you'd like to get the URL of:
PASSWORD
: Change passwordINBOX
: Hotmail inboxCOMPOSE
: Compose an E-mailMESSAGE
: Likely unusedFOLDERS
: MSN home?PERSON
: Modify account detailsMOBILE
: Setup MSN MobileCHGMOB
: Edit mobile settingsPROFILE
: Edit MSN Member Directory profileN2PACCOUNT
: Net2Phone account managementN2PFUND
: Net2Phone payment managmenetCHAT
: Chat roomsADDRBOOK
: Address Book, unused?ADVSEARCH
: Advanced Search, unused?INTSEARCH
: Internet Search, unused?
Where param
is an optional parameter to specify extra data about the request:
CHAT
: Supports a LCID parameter for localization. Example:0x0409
.PROFILE
: Supports a LCID parameter for localization. Example:0x0409
.N2PACCOUNT
: Supports a LCID parameter for localization. Example:0x0409
.COMPOSE
: Supports a target address. Example:example@hotmail.com
.
Server/Response
URL TrID redirect-url login-url {psid}
Where redirect-url
is either a relative URL to login-url
, using the rru
form parameter,
or an absolute URL to redirect to, using the ru
form parameter. Absolute URLs are supported since MSNP3.
Where login-url
is the service that provides automatic authentication
and accepts redirection form parameters. Usually https://login(net).passport.com/ppsecure/md5auth.srf?lc=
followed by your initial profile's lang_preference
value since MSNP3.
Where psid
is the id
parameter passed to login-url
. and are required to use absolute URLs as the redirect-url
. Added since MSNP3. Required since MSNP5
Examples
NOTE: All examples will have Site IDs because I don't know what the login URL was without it.
Open E-mail Inbox
C: URL 1 INBOX
S: URL 1 /cgi-bin/HoTMaiL https://loginnet.passport.com/ppsecure/md5autf.srf?lc=1033 2
Compose new E-mail
Without target
C: URL 2 COMPOSE
S: URL 2 /cgi-bin/compose https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 2
With target
C: URL 3 COMPOSE anotheruser@hotmail.com
S: URL 3 /cgi/bin/compose?mailto=1&to=anotheruser%40hotmail%2ecom https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 2
Setup MSN Mobile
Since MSNP5.
C: URL 4 MOBILE
S: URL 4 http://mobile.msn.com/hotmail/confirmUser.asp?URL=%2Fmessengerok.htm&mobID=1 https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 961
Edit Member Directory Profile
Since MSNP6.
C: URL 5 PROFILE 0x0409
S: URL 5 http://members.msn.com/Edit.asp?lc=1033 https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 4263
Manage Net2Phone account
Since MSNP6.
C: URL 6 N2PACCOUNT 0x0409
S: URL 6 https://ocs.net2phone.com/account/msnaccount/default.asp?_lang=0x0409 https://loginnet.passport.com/ppsecure/md5auth.srf?lc1033 2823
Open chat rooms
Since MSNP7.
C: URL 7 CHAT 0x0409
S: URL 7 http://chat.msn.com/Messenger.msnw?lc=1033 https://loginnet.passport.com/ppsecure/md5auth.srf?lc=1033 2260
Known changes
- MSNP3: Added a Passport Site ID parameter to response (parameter 3),
now supports absolute URLs. Removed
PASSWORD
service. - Client Version 3.0/MSNP5: Made the Passport Site ID parameter mandatory.
- MSNP5: Added
MOBILE
andCHGMOB
services. - MSNP6: Added
PROFILE
,N2PACCOUNT
andN2PFUND
services. - MSNP7: Added
CHAT
service. - MSNP8: Added
ADDRBOOK
,ADVSEARCH
andINTSEARCH
services.