Skip to main content

pages/{pageid}/feed/new (GET) (MT4)

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 title

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.
  • Was this article helpful?