105 lines
3.9 KiB
Markdown
105 lines
3.9 KiB
Markdown
# Introduction
|
|
`URL` is a command introduced with [MSNP2](../versions/msnp2.md).
|
|
|
|
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](../versions/msnp3.md).
|
|
|
|
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](../versions/msnp3.md).
|
|
|
|
Where `psid` is the `id` parameter passed to `login-url`. and are required to use absolute URLs as the `redirect-url`. Added since [MSNP3](../versions/msnp3.md). Required since [MSNP5](../versions/msnp5.md).
|
|
|
|
# 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](../versions/msnp3.md).*
|
|
```
|
|
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](../versions/msnp3.md).*
|
|
```
|
|
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](../versions/msnp6.md).*
|
|
```
|
|
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](../versions/msnp7.md).*
|
|
```
|
|
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](../versions/msnp3.md): Added a Passport Site ID parameter to response (parameter 3),
|
|
now supports absolute URLs. Removed `PASSWORD` service.
|
|
* Client Version 3.0/[MSNP5](../versions/msnp5.md): Made the Passport Site ID parameter mandatory.
|
|
* [MSNP5](../versions/msnp5.md): Added `MOBILE` and `CHGMOB` services.
|
|
* [MSNP6](../versions/msnp6.md): Added `PROFILE`, `N2PACCOUNT` and `N2PFUND` services.
|
|
* [MSNP7](../versions/msnp7.md): Added `CHAT` service.
|
|
* [MSNP8](../versions/msnp8.md): Added `ADDRBOOK`, `ADVSEARCH` and `INTSEARCH` services.
|