51 lines
1.3 KiB
Markdown
51 lines
1.3 KiB
Markdown
|
# Introduction
|
||
|
`ANS` is a command introduced with [MSNP2](../commands/msnp2.md).
|
||
|
|
||
|
It is a Switchboard Server command, without either a request or response payload.
|
||
|
|
||
|
Used to join ("answer") a Switchboard session ("call").
|
||
|
The response of this command sent after the [IRO](iro.md) list has been sent.
|
||
|
|
||
|
# Client/Request
|
||
|
`ANS TrID my-handle cookie session-id`
|
||
|
|
||
|
Where `my-handle` is the current user's handle.
|
||
|
In [MSNP16](../versions/msnp16.md), a UUID is appended after a semi-colon, which is your MPOP Machine ID.
|
||
|
|
||
|
Where `cookie` is the `cookie` from the RNG command sent to you.
|
||
|
|
||
|
Where `session-id` is the `session-id` from the RNG command sent to you.
|
||
|
|
||
|
# Server/Response
|
||
|
`ANS TrID OK`
|
||
|
|
||
|
Where `OK` is always `OK`.
|
||
|
|
||
|
# Examples
|
||
|
|
||
|
## Answering a RNG
|
||
|
```
|
||
|
C: ANS 1 example@hotmail.com 123456789.123456789.123456789 987654321
|
||
|
S: IRO 1 1 1 anotheruser@hotmail.com another%20user
|
||
|
S: ANS 1 OK
|
||
|
```
|
||
|
|
||
|
## Invalid session
|
||
|
*NOTE: There is no defined behavour for this command specificially."
|
||
|
```
|
||
|
C: ANS 2 example@hotmail.com bad data
|
||
|
```
|
||
|
|
||
|
Server disconnects client.
|
||
|
|
||
|
## Invalid context (Notification Server)
|
||
|
*Inherited from being an unimplemented command.*
|
||
|
```
|
||
|
C: ANS 3 example@hotmail.com wrong server
|
||
|
```
|
||
|
|
||
|
Server disconnects client.
|
||
|
|
||
|
# Known changes
|
||
|
* [MSNP16](../versions/msnp16.md): Added the current MPOP Machine ID to the `my-handle` parameter.
|