yellows111
f267b61dde
information for MSNP4 found: adds the client codebase parameter to SND and CVR (and an empty to CVQ, but that lasted all the way to MSNP7 lol, does that for MSNP3 fallback too which is kind of funny) 18 commands left.
104 lines
3.9 KiB
Markdown
104 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.
|