<interface>
    <name>del.icio.us</name>
    <description>
        <p>An almost complete description of the REST interface of the del.icio.us social
    bookmark site, excluding services requiring login</p>
        <p>Chris Wallace May 2009</p>
    </description>
    <endpoint>http://del.icio.us/</endpoint>
    <parameters>
        <parameter>
            <name>user-id</name>
            <purpose>User Identifier</purpose>
            <default>morelysq</default>
            <tag>model</tag>
        </parameter>
        <parameter>
            <name>tag</name>
            <purpose>a group of bookmarks</purpose>
            <default>xml</default>
            <tag>model</tag>
        </parameter>
        <parameter>
            <name>url</name>
            <purpose>bookmark</purpose>
            <default>http://xml.com/</default>
            <tag>model</tag>
        </parameter>
        <parameter>
            <name>tagview</name>
            <purpose>the tag list appearance</purpose>
            <options>
                <option>list</option>
                <option>cloud</option>
            </options>
            <default>list</default>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>tagsort</name>
            <purpose>the order of tags in the tag list</purpose>
            <options>
                <option>alpha</option>
                <option>freq</option>
            </options>
            <default>list</default>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>minfreq</name>
            <purpose>the minimum frequency of a tag to appear in the tag list</purpose>
            <options>
                <option>1</option>
                <option>2</option>
                <option>5</option>
            </options>
            <default>1</default>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>bundleview</name>
            <purpose>whether bundles are shown</purpose>
            <options>
                <option>show</option>
                <option>hide</option>
            </options>
            <default>show</default>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>pageno</name>
            <purpose>the page of the bookmark list</purpose>
            <format>[0-9]+</format>
            <default>1</default>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>count</name>
            <purpose>the number of bookmarks to shown per page</purpose>
            <options>
                <option>10</option>
                <option>25</option>
                <option>50</option>
                <option>100</option>
            </options>
            <default>10</default>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>search</name>
            <purpose>search string</purpose>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>scope</name>
            <purpose>search scope</purpose>
            <options>
                <option>user</option>
                <option>all</option>
                <option>web</option>
            </options>
            <default>all</default>
            <tag>ui</tag>
        </parameter>
        <parameter>
            <name>helptopic</name>
            <purpose>a page of the help manual</purpose>
            <default>urlhistory</default>
            <tag>help</tag>
        </parameter>
    </parameters>
    <services>
        <service>
            <template/>
            <purpose>Home Page</purpose>
            <tag>home</tag>
        </service>
        <service>
            <template>{user-id}</template>
            <purpose>View a user's public bookmarks</purpose>
            <tag>user</tag>
        </service>
        <service>
            <template>{user-id}?settagview={tagview}&amp;settagsort={tagsort}&amp;setminfreq={minfreq}&amp;setbundleview={bundleview}&amp;page={pageno}&amp;setcount={count}</template>
            <purpose>View a user's public bookmarks, controlling its appearance</purpose>
            <tag>user</tag>
        </service>
        <service>
            <template>rss/{user-id}</template>
            <purpose>Get an RSS feed of a user's bookmarks - limited to the latest 20 items</purpose>
            <tag>user</tag>
            <tag>RSS</tag>
        </service>
        <service>
            <template>{user-id}/{tag}</template>
            <purpose>View a user's bookmarks by tag</purpose>
            <tag>user</tag>
            <tag>tag</tag>
        </service>
        <service>
            <template>tag/{tag}</template>
            <purpose>View tagged bookmarks</purpose>
            <tag>tag</tag>
        </service>
        <service>
            <template>network/{user-id}</template>
            <purpose>View a user's network and their tags</purpose>
            <tag>user</tag>
            <tag>network</tag>
        </service>
        <service>
            <template>subscriptions/{user-id}</template>
            <purpose>View a user's subscriptions - i.e.watched bookmarks</purpose>
            <tag>user</tag>
            <tag>subscriptions</tag>
        </service>
        <service>
            <template>for/{user-id}</template>
            <purpose>View links suggested to a user</purpose>
            <tag>user</tag>
            <tag>links</tag>
        </service>
        <service>
            <template>rss/tag/{tag}</template>
            <purpose>Get an RSS feed of tagged bookmarks</purpose>
            <tag>tag</tag>
            <tag>RSS</tag>
        </service>
        <service>
            <template>popular/{tag}</template>
            <purpose>View popular tagged bookmarks</purpose>
            <tag>tag</tag>
        </service>
        <service>
            <template>popular/</template>
            <purpose>View today's popular bookmarks</purpose>
            <tag>current</tag>
        </service>
        <service>
            <template>popular/?new</template>
            <purpose>View today's new popular bookmarks</purpose>
            <tag>current</tag>
        </service>
        <service>
            <template>url?url={url}</template>
            <purpose>View Bookmarks for a URL</purpose>
            <tag>url</tag>
        </service>
        <service>
            <template>help/</template>
            <purpose>Help index</purpose>
            <tag>help</tag>
        </service>
        <service>
            <template>help/{helptopic}</template>
            <purpose>View a page of the help manual</purpose>
            <tag>help</tag>
        </service>
        <service>
            <template>search/?fr=del_icio_us&amp;p={search}&amp;searchtype={scope}</template>
            <purpose>Search for string in different scopes</purpose>
            <tag>search</tag>
        </service>
        <service>
            <template>rss/</template>
            <purpose>RSS hotlist feed</purpose>
            <tag>current</tag>
            <tag>RSS</tag>
        </service>
        <service>
            <template>rss/tag/{tag}</template>
            <purpose>RSS feed for a tag</purpose>
            <tag>tag</tag>
            <tag>RSS</tag>
        </service>
        <service>
            <template>html/{user-id}/</template>
            <purpose>Get a contolled HTML extract of a user's tag</purpose>
            <tag>user</tag>
            <tag>html</tag>
        </service>
    </services>
</interface>