Overview

public. Retrieve feed of site changes

Uri Parameters

None

Query Parameters
NameTypeDescription
authenticatebool?Force authentication for request (default: false)
format{all, daily, raw, rawdaily}?Format for feed (default: daily)
languagestring?Filter results by language (default: all languages)
limitint?Number of changes to retrieve (default: 100)
offsetint?Skipped changes (default: 0)
sincestring?Start date for changes. Date is provided in 'yyyyMMddHHmmss' format (default: ignored).
Return Codes
NameValueDescription
BadRequest400Invalid input parameter or request body
Forbidden403Suscribe access to the page is required
Ok200The request completed successfully

Message Format

Output (Atom):  Refer to http://www.w3.org/2005/Atom

Output (Digest/Raw):

<digest>
    <change>
        <rc_id>{int}</rc_id> 
        <rc_comment>{text}</rc_comment> 
        <rc_cur_id>{int}</rc_cur_id> 
        <rc_last_oldid>{int}</rc_last_oldid> 
        <rc_namespace>{int}</rc_namespace> 
        <rc_timestamp>{date}</rc_timestamp> 
        <rc_title>{text}</rc_title> 
        <rc_type>{int}</rc_type> 
        <rc_moved_to_ns>{int}</rc_moved_to_ns> 
        <rc_moved_to_title>{text}</rc_moved_to_title> 
        <rc_user_name>{text}</rc_user_name> 
        <rc_watched>{int}</rc_watched> 
        <rc_page_exists>{int}</rc_page_exists> 
        <edit_count>{int}</edit_count> 
    </change>
    ...
</digest>

Implementation Notes

Atom and Digest formats retrieve a compressed summary of recent changes, whereas the Raw format lists each change individually.

Code Samples

The following code example retrieves the recent changes feed:

Plug p = Plug.New("http://deki-hayes/@api/deki");
p.At("users", "authenticate").WithCredentials("admin", "password").Get();
p.At("site", "feed").Get();

Sample response feed indicating that the page called "Page Title" was edited four times:

<feed xmlns="http://www.w3.org/2005/Atom" version="1.0" xml:lang="en-us">
  <generator version="1.3.99.23727">MindTouch Dream XAtom</generator> 
  <updated>2007-08-30T00:29:02Z</updated> 
  <title type="text">What's New - DekiWiki (Hayes)</title> 
  <link rel="self" href="http://deki-hayes/@api/deki/site/feed?format=atom" /> 
  <id>http://deki-hayes/@api/deki/site/feed?format=atom</id>  
    <entry>
        <title type="text">Page Title</title> 
        <published>2007-08-29T19:14:29Z</published> 
        <updated>2007-08-29T19:14:29Z</updated> 
        <id>http://deki-hayes/Page_Title</id> 
        <author>
            <name>Admin</name> 
        </author>
        <link href="http://deki-hayes/Page_Title" rel="alternate" /> 
        <summary type="xhtml">
            <div xmlns="http://www.w3.org/1999/xhtml">
                <p>Edited 4 times by Admin (added 'myfile.jpg')</p> 
                <p>
                    <strong>2 words added, 1 words removed</strong> 
                </p>
                <hr width="100%" size="2" /> 
                <p>
                    <ins style="color: #009900;background-color: #ccffcc;text-decoration: none;">new</ins> 
                    <del style="color: #990000;background-color: #ffcccc;text-decoration: none;">original</del> 
                    text 
                    <ins style="color: #009900;background-color: #ccffcc;text-decoration: none;">2</ins> 
                </p>
            </div>
        </summary>
    </entry>
</feed>
Tag page
You must login to post a comment.