msnp-wiki/docs/commands/url.md

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 password
  • INBOX: Hotmail inbox
  • COMPOSE: Compose an E-mail
  • MESSAGE: Likely unused
  • FOLDERS: MSN home?
  • PERSON: Modify account details
  • MOBILE: Setup MSN Mobile
  • CHGMOB: Edit mobile settings
  • PROFILE: Edit MSN Member Directory profile
  • N2PACCOUNT: Net2Phone account management
  • N2PFUND: Net2Phone payment managmenet
  • CHAT: Chat rooms
  • ADDRBOOK: Address Book, unused?
  • ADVSEARCH: Advanced Search, unused?
  • INTSEARCH: Interest 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 and CHGMOB services.
  • MSNP6: Added PROFILE, N2PACCOUNT and N2PFUND services.
  • MSNP7: Added CHAT service.
  • MSNP8: Added ADDRBOOK, ADVSEARCH and INTSEARCH services.