Protocols/OSCAR/SNAC/USER LOOKUP FIND BY EMAIL: Difference between revisions
No edit summary |
|||
| Line 131: | Line 131: | ||
It would appear that AIM no longer has the feature of being able to find by name. That now takes you to the address: http://www.aol.com/netfind/whitepages.html. I sure thought it used to do this.... | It would appear that AIM no longer has the feature of being able to find by name. That now takes you to the address: http://www.aol.com/netfind/whitepages.html. I sure thought it used to do this.... | ||
=== From Aleksandr Shutko: SNAC(0A,02) client search by email request SNAC(0A,02) CLI_SEARCHxBYxEMAIL === | |||
<table width=640 cellSpacing=0 cellPadding=0 border=0> | |||
<tr> | |||
<td> | |||
<br> | |||
Use this to search AIM account by email address associated with it. | |||
Server will reply via [[Protocols/OSCAR/SNAC_0a_03||SNAC(0A,03)]] or via | |||
[[Protocols/OSCAR/SNAC_0a_01||SNAC(0A,01)]] - error.<br><br> | |||
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td> | |||
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td bgcolor=#E9E9E9 > | |||
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0> | |||
<tr> | |||
<td width=30%> 00 0A</td> | |||
<td width=5> </td> | |||
<td>word</td> | |||
<td width=5> </td> | |||
<td width=55%>SNAC family</td> | |||
</tr> | |||
<tr> | |||
<td> 00 02</td> | |||
<td width=5> </td> | |||
<td>word</td> | |||
<td width=5> </td> | |||
<td width=55%>SNAC subtype</td> | |||
</tr> | |||
<tr> | |||
<td> 00 00</td> | |||
<td width=5> </td> | |||
<td>word</td> | |||
<td width=5> </td> | |||
<td width=55%>SNAC flags</td> | |||
</tr> | |||
<tr> | |||
<td> xx xx xx xx</td> | |||
<td width=5> </td> | |||
<td>dword</td> | |||
<td width=5> </td> | |||
<td width=55%>SNAC request-id</td> | |||
</tr> | |||
</table> | |||
</td></tr> | |||
<tr><td bgcolor=#E9E9E9 > | |||
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0> | |||
<tr> | |||
<td width=30%> xx ..</td> | |||
<td width=5> </td> | |||
<td>string</td> | |||
<td width=5> </td> | |||
<td width=55%>email address string</td> | |||
</tr> | |||
</table> | |||
</td></tr></table> | |||
</td></tr></table> | |||
</td></tr></table> | |||
<br>Example SNAC dump with flap header: | |||
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td> | |||
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr> | |||
<td bgcolor=#E9E9E9> | |||
<font size=3><pre style="font-size: 13px"> | |||
2A 02 33 73 00 17 00 0A 00 02 00 00 00 00 00 02 *.3s............ | |||
61 61 61 61 61 40 61 61 61 61 2E 72 75 aaaaa@aaaa.ru | |||
</pre></font> | |||
</td></tr></table> | |||
</td></tr></table> | |||
=== USER_LOOKUP SNACs === | === USER_LOOKUP SNACs === | ||
Revision as of 01:10, 13 February 2021
| OSCAR Protocol |
| Introduction • Terms • Clients |
| Basic |
| Datatypes • FLAP • SNAC • TLV |
| UUIDs • Errors • Tool IDs |
| Host Interaction |
| Rate Limits • Migration • Messages |
| Other Services |
| ADMIN • ADVERT • ALERT |
| BART • BOS • BUCP • CHAT |
| CHAT_NAV |
| Tutorials |
| Sign On • BART • Rendezvous |
| ICBM • Locate • Buddies |
| Foodgroups |
| OSERVICE (0x0001) |
| LOCATE (0x0002) |
| BUDDY (0x0003) |
| ICBM (0x0004) |
| ADVERT (0x0005) |
| INVITE (0x0006) |
| ADMIN (0x0007) |
| POPUP (0x0008) |
| PD (0x0009) |
| USER_LOOKUP (0x000A) |
| STATS (0x000B) |
| TRANSLATE (0x000C) |
| CHAT_NAV (0x000D) |
| CHAT (0x000E) |
| ODIR (0x000F) |
| BART (0x0010) |
| FEEDBAG (0x0013) |
| ICQ (0x0015) |
| BUCP (0x0017) |
| ALERT (0x0018) |
| PLUGIN (0x0022) |
| UNNAMED_FG_24 (0x0024) |
| MDIR (0x0025) |
| ARS (0x044A) |
| ID | Origin | Name | Foodgroup | Service | Status | Version |
|---|---|---|---|---|---|---|
| 0x000A, 0x0002 | Client | USER_LOOKUP__FIND_BY_EMAIL | Unspecified | BOS | Active | 1.9 |
Search for other users by email address.
SNAC Header
| Foodgroup | uint16 (word) | 00 0A |
| Subgroup | uint16 (word) | 00 02 |
| Flags | uint16 (word) | 00 00 |
| Request ID | uint32 (dword) | 00 00 00 00 |
SNAC Data
Unconfirmed: This SNAC contains no data
6.3 Finding People
The OSCAR BOS (basic services) allows a few rudimentrary methods of locating other AIM and AOL users.
6.3.1 Finding by EMail Address
A "find SN by email address" request is facilitated by the "Request Screen Name by Address" command in next table.
Fig 6.3.1.1 Request Screen Name by Address
| Position | Length | Data |
| 1 | Word | 0x000a |
| 3 | Word | 0x0002 |
| 5 | Word | 0x0000 |
| 7 | DWord | Request ID |
| 11 | ASCII String | Email Address (unterminated) |
Please notice the lack of a length byte/word prefixed to the email address. It's kind of strange for this derivation in behavior, but AOL can do what they want.
The server's response to that is the "Search by Address Response" command, explaned in the next table. Please note that there may be several screen names per email address.
Fig 6.3.1.2 Search by Address Response
| Position | Length | Data |
| 1 | Word | 0x000a |
| 3 | Word | 0x0003 |
| 5 | Word | 0x0000 |
| 7 | DWord | Request ID |
| 11* | Word | 0x0001 |
| 13* | Word | SN Length |
| 15* | ASCII String | SN (unterminated) |
| * Field repeats for every listed screen name. | ||
And if no screen names are found, we get the "Search by Address Response Fail" command below.
Fig 6.3.1.3 Search by Address Fail
| Position | Length | Data |
| 1 | Word | 0x000a |
| 3 | Word | 0x0001 |
| 5 | Word | 0x0000 |
| 7 | DWord | Request ID |
| 11 | Word | 0x0014 |
6.3.2 Finding by Name
It would appear that AIM no longer has the feature of being able to find by name. That now takes you to the address: http://www.aol.com/netfind/whitepages.html. I sure thought it used to do this....
From Aleksandr Shutko: SNAC(0A,02) client search by email request SNAC(0A,02) CLI_SEARCHxBYxEMAIL
|
|
Example SNAC dump with flap header:
|
USER_LOOKUP SNACs
| |||||||||||||||||||||