Implementing OwnCloud API v1: Get updated items #15

Closed
opened 7 years ago by dustinwilson · 0 comments
Owner

Get updated items

This is used to stay up to date.

  • Method: GET
  • Route: /items/updated
  • Parameters:
{
  "lastModified": 123231, // returns only items with a lastModified timestamp >= than this one
                          // this may also return already existing items whose read or starred status
                          // has been changed
  "type": 1, // the type of the query (Feed: 0, Folder: 1, Starred: 2, All: 3)
  "id": 12 // the id of the folder or feed, Use 0 for Starred and All
}
  • Returns:
{
  "items": [
    {
      "id": 3443,
      "guid": "http://grulja.wordpress.com/?p=76",
      "guidHash": "3059047a572cd9cd5d0bf645faffd077",
      "url": "http://grulja.wordpress.com/2013/04/29/plasma-nm-after-the-solid-sprint/",
      "title": "Plasma-nm after the solid sprint",
      "author": "Jan Grulich (grulja)",
      "pubDate": 1367270544,
      "body": "<p>At first I have to say...</p>",
      "enclosureMime": null,
      "enclosureLink": null,
      "feedId": 67,
      "unread": true,
      "starred": false,
      "lastModified": 1367273003,
      "fingerprint": "aeaae2123"  // new in 8.4.0 hash over title, enclosures, body and url. Same fingerprint means same item and it's advised to locally mark the other one read as well and filter out duplicates in folder and all articles view
    }, // etc
  ]
}
## Get updated items This is used to stay up to date. * **Method**: GET * **Route**: /items/updated * **Parameters**: ```js { "lastModified": 123231, // returns only items with a lastModified timestamp >= than this one // this may also return already existing items whose read or starred status // has been changed "type": 1, // the type of the query (Feed: 0, Folder: 1, Starred: 2, All: 3) "id": 12 // the id of the folder or feed, Use 0 for Starred and All } ``` * **Returns**: ```js { "items": [ { "id": 3443, "guid": "http://grulja.wordpress.com/?p=76", "guidHash": "3059047a572cd9cd5d0bf645faffd077", "url": "http://grulja.wordpress.com/2013/04/29/plasma-nm-after-the-solid-sprint/", "title": "Plasma-nm after the solid sprint", "author": "Jan Grulich (grulja)", "pubDate": 1367270544, "body": "<p>At first I have to say...</p>", "enclosureMime": null, "enclosureLink": null, "feedId": 67, "unread": true, "starred": false, "lastModified": 1367273003, "fingerprint": "aeaae2123" // new in 8.4.0 hash over title, enclosures, body and url. Same fingerprint means same item and it's advised to locally mark the other one read as well and filter out duplicates in folder and all articles view }, // etc ] } ```
jking closed this issue 7 years ago
Sign in to join this conversation.
No Milestone
No Assignees
1 Participants
Notifications
Due Date

0000-12-31

Dependencies

This issue currently doesn't have any dependencies.

Loading…
There is no content yet.