Emoticons

To request a list of emoticons, clients may send an IQ with an optional ver attribute set to the version string returned the last time emoticons were fetched. Note that though the version string looks like a date in the following examples, it MUST NOT be considered to have meaning. Version strings are opaque to the client.

<!-- Client -->
<iq type="get" id="1">
    <query xmlns="http://hipchat.com/protocol/emoticons"
           ver="2012-08-21T11:43Z"/>
</iq>

The server will then respond with a new list if the emoticons list has been updated. When this happens, clients SHOULD cache the new version string to use in future queries and all of the returned emoticons.

<!-- Server -->
<iq to="1_1@chat.hipchat.com/mac" id="1" type="result">
    <query xmlns="http://hipchat.com/protocol/emoticons"
           ver="2012-08-21T12:00Z">
        <path_prefix>
            https://example.com/img/emoticons
        </path_prefix>
        <item>
            <id>2</id>
            <path>lolwut.gif</path>
            <shortcut>lolwut</shortcut>
            <w>25</w>
            <h>25</h>
        </item>
        <item>...</item>
        <item>...</item>
        <item>...</item>
    </emoticons>
</iq>

If the version string provided by the client matches the string on the server, an empty result is returned:

<!-- Server -->
<iq to="1_1@chat.hipchat.com/mac" id="1" type="result" />