users/{userid}/feed (GET) - deprecated - MindTouch Success Center

Overview

Retrieve feed of user contributions

REST Method: GET
Method Access: public

Uri Parameters

Name	Type	Description
userid	string	either an integer user ID, "current", or "=" followed by a double uri-encoded user name

Query Parameters

Name	Type	Description
authenticate	bool?	Force authentication for request (default: false)
format	{all, daily, raw, rawdaily}?	Format for feed (default: daily)
offset	int?	Skipped changes (default: 0)
limit	int?	Number of changes to retrieve (default: 100)
since	string?	Start date for changes. Date is provided in 'yyyyMMddHHmmss' format (default: ignored).

Return Codes

Name	Value	Description
OK	200	The request completed successfully
Bad Request	400	Invalid input parameter or request body
Forbidden	403	Suscribe access is required
Not Found	404	Requested user could not be found

Message Format

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

Output (Digest/Raw):

<table>
    <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>
    ...
</table>

Implementation Notes

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

C# Code Sample: Retrieve Feed of Changes made by User

The following code example retrieves the feed of changes by the current user:

Sample Code

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

Sample Response from executing Code

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

<feed xmlns="http://www.w3.org/2005/Atom" version="1.0" xml:lang="en-us">
    <generator version="1.3.99.4871">MindTouch Dream XAtom</generator> 
    <updated>2007-08-29T20:12:49Z</updated> 
    <title type="text">Admin's contributions</title> 
    <link rel="self" href="http://deki-hayes/@api/deki/users/current/feed" /> 
    <id>http://deki-hayes/@api/deki/users/current/feed</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>

Curl Code Sample: Retrieve Feed of Changes made by User

The following command returns a feed containing a list of page modifications made by user "foo":

Sample Code

curl -u username:password -i http://mindtouch.address/@api/deki/users/=foo/feed

Sample Response from executing Code

Example of a user feed:

Content-Type: application/xml

<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-us">
  <generator version="2.0.0.17704">MindTouch Dream XAtom</generator>
  <updated>2010-02-02T22:33:14Z</updated>
  <title type="text">spock's contributions</title>
  <link rel="self" href="http://192.168.59.128/@api/deki/users/=spock/feed"/>
  <id>http://192.168.59.128/@api/deki/users/=spock/feed</id>
  <entry>
    <title type="text">Bar</title>
    <published>2010-01-19T01:22:29Z</published>
    <updated>2010-01-19T01:22:29Z</updated>
    <id>http://192.168.59.128/Bar#20100119012229</id>
    <author>
      <name>spock</name>
    </author>
    <link href="http://192.168.59.128/Bar" rel="alternate"/>
    <summary type="xhtml">
      <div xmlns="http://www.w3.org/1999/xhtml">
        <p>Edited once by spock</p>
        <p>removed 'trollface.jpg'</p>
        <table border="0" padding="5" width="80%">
          <tr>
            <td>
              <a href="http://192.168.59.128/index.php?title=Bar">View page</a>
            </td>
            <td>
              <a href="http://192.168.59.128/Special:Userban?username=spock">Ban spock</a>
            </td>
          </tr>
        </table>
      </div>
    </summary>
  </entry>
</feed>

Implementation notes

curl flags

-u: Provides external user authentication. Note that if anonymous access is available and authentication is not forced, this flag may be omitted.
-i: Outputs the HTTP response headers. Useful for debugging.

Users

To view a list of all users, follow the instructions here.