GET:pages/{pageid}/tree

Overview

public. Builds a site map starting from a given page.

Message Format

Output (XML):

<pages>
    <page id="{int}" href="{uri}">
        <title>{text}</title> 
        <path>{text}</path> 
        <subpages>
            <page>...</page>
            ...
        </subpages>
    </page>
</pages>

Output (HTML):

<ul>
    <li>
        <a rel="internal" href="{uri}" title="{text}" pageid="{int}" class="{text}">{text}</a>
        <ul>
            <li>...</li>
            ...
        </ul>
    </li>
</ul>

Output (sitemap): Refer to http://www.google.com/schemas/sitemap/0.84

Implementation Notes

Redirect and archived pages are not included in the sitemap.

Use GET:pages to retrieve the full sitemap.

Code Samples

The following code example retrieves the sitemap from the page called "Page Title" in XML format:

Plug p = Plug.New("http://deki-hayes/@api/deki");
p.At("users", "authenticate").WithCredentials("admin", "password").Get();
p.At("pages", "=Page_Title").With("format", "xml").Get();

Sample response indicating that "Page Title" has one subpage called "Subpage 1":

<pages>
    <page id="31" href="http://deki-hayes/@api/deki/pages/31">
        <title>Page Title</title> 
        <path>Page_Title</path> 
        <subpages>
            <page id="32" href="http://deki-hayes/@api/deki/pages/32">
                <title>Subpage 1</title> 
                <path>Page_Title/Subpage_1</path> 
                <subpages /> 
            </page>
        </subpages>
    </page>
</pages>