msnp-wiki/docs/commands/fqy.md
yellows111 ce7c3bee1c
0.2.0: The Winter Roll-up
i have basically touched every file help

* Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time.
* Rename passport (soap) to RST
* Formatting changes (many)
* Several corrections
* change git host because git.kevinthe.horse seems Dead
2024-12-18 20:16:29 +00:00

105 lines
1.8 KiB
Markdown

# Introduction
`FQY` is a command introduced with [MSNP14](../versions/msnp14.md).
It is a Notification Server command, WITH a request and WITH a response payload.
Requests the server on which Network ID the user is assigned to.
# Client/Request
```
FQY TrID length
payload
```
Where `payload` is a [`<ml>`](#ml) document, without any support for whitespace outside of element parameters.
## ml
This element supports one or multiple `<d>` elements.
### d
This element has one attribute:
* `n`: The domain (`...@this`) of the user handle.
This element contains one or multiple `<c>` elements.
#### c
This element has two attributes:
* `n`: The local part (`this@...`) of the user handle.
* `t`: The Network ID that this user is associated with.
This parameter is to be omitted by the client, but not the server.
# Server/Response
```
FQY TrID length
payload
```
Where payload is a [`<ml>`](#ml) document, without any support for whitespace outside of element parameters.
# Examples
*NOTE: The XML in these examples has been exploded for visibility and formatting reasons.
No whitespace is allowed in FQY's payload and the payload size reflects this,
and is set to the correct value.*
## User on the same service
```
C: FQY 1 53
<ml>
<d n="hotmail.com">
<c n="anotheruser" />
</d>
</ml>
S: FQY 1 59
<ml>
<d n="hotmail.com">
<c n="anotheruser" t="1" />
</d>
</ml>
```
## User on another service
```
C: FQY 2 53
<ml>
<d n="hotmail.com">
<c n="anotheruser" />
</d>
</ml>
S: FQY 2 60
<ml>
<d n="hotmail.com">
<c n="anotheruser" t="32" />
</d>
</ml>
```
## No services specified
```
C: FQY 3 9
<ml></ml>
S: 240 3
```
## No domain name specified
```
C: FQY 4 16
<ml>
<d>
</d>
</ml>
S: 241 4
```
## Target user not found
```
C: FQY 5 47
<ml>
<d n="hotmail.com">
<c n="ghost" />
</d>
</ml>
S: 208 5
```
# Known changes
None.