users/{userid}/feed (GET) - deprecated
Deprecated! This functionality is deprecated and no longer supported.
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.