pages/{pageid}/feed/new (GET) - deprecated
Deprecated! This functionality is deprecated and no longer supported.
Overview
Retrieve feed of new page creations
- REST Method: GET
- Method Access: public
Uri Parameters
Name | Type | Description |
pageid | string | either an integer page ID, "home", or "=" followed by a double uri-encoded page path |
Query Parameters
Name | Type | Description |
includeDeleted | bool? | Include deleted pages in the authorization. Default is false |
timezone | string? | Optionally indicate a timezone so that the news feed displays the messages with the timestamp adjusted to the preferred timezone (e.g. -09:00, the default is empty) |
authenticate | bool? | Force authentication for request (default: false) |
redirects | int? | If zero, do not follow page redirects. |
filter | string? | use "new" to include only newly created pages in the feed (default: all) |
depth | string? | How deep into the sub-tree changes should be included. 0 for the current page only, 'infinity' for entire sub-tree (default: 0) |
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 | Read/suscribe access to the page is required |
Not Found | 404 | Requested page could not be found |
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_this_oldid>{int}</rc_this_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_full_name>{text}</rc_full_name> <rc_watched>{int}</rc_watched> <rc_page_exists>{int}</rc_page_exists> <rc_revision>{int}</rc_revision> <cmnt_deleted>{int}</cmnt_deleted> <old_is_hidden>{bool}</old_is_hidden> </change> ... </digest>
Implementation Notes
Atom and Digest formats retrieve a compressed summary of recent changes, whereas the Raw format lists each change individually.
DekiScript Code Example
var now = date.now; var since = date.adddays(now,-7); let since = date.format(since, "yyyyMMddHHmmss"); var changesuri = site.api & 'pages/8521/feed/new' & {since:since, limit: 10, format: "all", namespace: "main" }; var api = wiki.api(changesuri); var count = #api['entry']; count;
Curl Code Sample: Retrieve Feed of New Pages
The following command returns a feed containing a list of all page creations relative to the hierarchy of page "foo". To retrieve a feed of all page creations, use special page ID "home" in place of "=foo".
Sample Code
curl -u username:password -i http://mindtouch.address/@api/deki/pages/=foo/feed/new
Sample Response from executing Code
Example of a new page feed relative to page "A". In this example, page A is created, and then page B is created as a subpage of A.
Command
curl -u admin:password -i http://192.168.59.128/@api/deki/pages/=A/feed/new?format=raw
XML Response
format: raw
Content-Type: application/xml
<table> <change> <rc_id>111496</rc_id> <rc_comment>page created, 10 words added</rc_comment> <rc_cur_id>43907</rc_cur_id> <rc_last_oldid>0</rc_last_oldid> <rc_this_oldid>0</rc_this_oldid> <rc_namespace>0</rc_namespace> <rc_timestamp>20100603180443</rc_timestamp> <rc_title>A/B</rc_title> <rc_type>1</rc_type> <rc_moved_to_ns>0</rc_moved_to_ns> <rc_moved_to_title/> <rc_user_name>Admin</rc_user_name> <rc_full_name/> <rc_page_exists>1</rc_page_exists> <rc_revision>1</rc_revision> <cmnt_deleted>0</cmnt_deleted> <old_is_hidden>false</old_is_hidden> </change> <change> <rc_id>78904</rc_id> <rc_comment>page created</rc_comment> <rc_cur_id>33259</rc_cur_id> <rc_last_oldid>0</rc_last_oldid> <rc_this_oldid>2058</rc_this_oldid> <rc_namespace>0</rc_namespace> <rc_timestamp>20100524212959</rc_timestamp> <rc_title>A</rc_title> <rc_type>1</rc_type> <rc_moved_to_ns>0</rc_moved_to_ns> <rc_moved_to_title/> <rc_user_name>Admin</rc_user_name> <rc_full_name/> <rc_page_exists>1</rc_page_exists> <rc_revision>4</rc_revision> <cmnt_deleted>0</cmnt_deleted> <old_is_hidden>false</old_is_hidden> </change> </table>
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.
Pages
- To view a list of all pages, follow the instructions here.