yellows111
4bf934f857
update version file, forgot this repo had one fix mistakes and other such add new information finish passport (SOAP) stuff, may rename to RST later?, just mention in footnote for now next commit WILL be msnp13 on 0.1.4 release, promise
3 KiB
Introduction
PGD is a command introduced with MSNP9.
It is a Notification Server command, with a request payload.
It sends a text message to a mobile device/pager or Web Watch. For the version of this command that doesn't support Web watches, read PAG. For the command that is sent when you receive a page, read IPG.
Client/Request
PGD TrID user-handle device-type length
payload
Where user-handle is the target user for this page.
Where device-type is a number:
- 1: Mobile Device
- 2: Web Watch
Where length is the size (in bytes) of the payload.
Where payload is a XML-like payload that encodes the following characters:
&turns into&;turns into;<turns into<>turns into>^turns into^
Server/Response
This command only supports negative-acknowledgement responses only. There is no postive acknowledgement response.
Examples
Sending to a mobile device
Sending without a callback number
C: PGD 1 anotheruser@hotmail.com 1 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
Sending with a home callback number
NOTE: The number used was 1 (555) 111-4444.
C: PGD 2 anotheruser@hotmail.com 1 161
<PHONE pri="1"><LOC>HOME</LOC><NUM>15551114444</NUM></PHONE><TEXT xml:space="preserve" enc="utf-8">This is an example message with a home callback number.</TEXT>
Sending with a work callback number
NOTE: The number used was 1 (555) 222-5555.
C: PGD 3 anotheruser@hotmail.com 1 161
<PHONE pri="1"><LOC>WORK</LOC><NUM>15552225555</NUM></PHONE><TEXT xml:space="preserve" enc="utf-8">This is an example message with a work callback number.</TEXT>
Sending with a mobile callback number
NOTE: The number used was 1 (555) 333-6666.
C: PGD 4 anotheruser@hotmail.com 1 165
<PHONE pri="1"><LOC>MOBILE</LOC><NUM>15553336666</NUM></PHONE><TEXT xml:space="preserve" enc="utf-8">This is an example message with a mobile callback number.</TEXT>
Failed to send
This error may be a generic server error.
C: PGD 5 anotheruser@hotmail.com 1 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
S: 800 5
To a Web Watch
NOTE: Trying to do this with the buddy property
MOB set to Y is impossible in the official client.
Normal use
C: PGD 6 anotheruser@hotmail.com 2 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
Failed to send
This error may be a generic server error.
C: PGD 7 anotheruser@hotmail.com 2 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
S: 800 7
To an invalid device type
Numeric types
C: PGD 8 anotheruser@hotmail.com 0 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
S: 201 8
Other character types
C: PGD 9 anotheruser@hotmail.com W 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
Server disconnects client.
Known changes
None.