list-items.md

List Items

Page through your items. For the best performance, make sure your requests:

• Read and set cookies.
• Read the Etag header on the responses to set the If-None-Match header on future requests.
• Read the Last-Modified header on responses to set the If-Modified-Since header on future requests.

If you're lucky, the HTTP library you use will take care of this for you.

Request

• Requires authentication
• HTTP Method: GET
• URL: http://my.cl.ly/items
• Optional paramters:
  • page=1: Page number starting at 1.
  • per_page=5: Number of items per page.
  • type=image: Filter items by type (image, bookmark, text, archive, audio, video, or unknown).
  • deleted=true: Show trashed items.
  • source=MyApp: Filter items by all or part of the User-Agent.

Response

• Status: 200 OK

• Body:

  [{
    "href":          "http://my.cl.ly/items/1912729",
    "name":          "My CloudApp",
    "private":       true,
    "subscribed":    false,
    "url":           "http://cl.ly/40b6ab341aca432a34ee",
    "content_url":   "http://cl.ly/40b6ab341aca432a34ee",
    "item_type":     "bookmark",
    "view_counter":  0,
    "icon":          "http://my.cl.ly/images/item_types/bookmark.png",
    "remote_url":    null,
    "redirect_url":  "http://my.cl.ly",
    "source":        "Cloud/1.5.1 CFNetwork/520.0.13 Darwin/11.0.0 (x86_64) (MacBookPro5%2C5)",
    "created_at":    "2010-10-23T20:10:37Z",
    "updated_at":    "2010-10-23T20:10:41Z",
    "deleted_at":    null
  }, {
    "href":          "http://my.cl.ly/items/1912565",
    "name":          "CloudApp",
    "private":       false,
    "subscribed":    false,
    "url":           "http://cl.ly/2wt6",
    "content_url":   "http://cl.ly/2wt6",
    "item_type":     "bookmark",
    "view_counter":  2,
    "icon":          "http://my.cl.ly/images/item_types/bookmark.png",
    "remote_url":    null,
    "redirect_url":  "http://getcloudapp.com",
    "source":        "Cloud/1.5.1 CFNetwork/520.0.13 Darwin/11.0.0 (x86_64) (MacBookPro5%2C5)",
    "created_at":    "2010-10-23T19:50:24Z",
    "updated_at":    "2010-10-23T19:50:39Z",
    "deleted_at":    null
  }, {
    "href":          "http://my.cl.ly/items/1912559",
    "name":          "CloudApp Logo.png",
    "private":       false,
    "subscribed":    false,
    "url":           "http://cl.ly/2wr4",
    "content_url":   "http://cl.ly/2wr4/CloudApp%20Logo.png",
    "item_type":     "image",
    "view_counter":  85,
    "icon":          "http://my.cl.ly/images/new/item-types/image.png",
    "remote_url":    "http://f.cl.ly/items/7c7aea1395c3db0aee18/CloudApp%20Logo.png",
    "thumbnail_url": "http://thumbs.cl.ly/2wr4",
    "redirect_url":  null,
    "source":        "Cloud/1.5.1 CFNetwork/520.0.13 Darwin/11.0.0 (x86_64) (MacBookPro5%2C5)",
    "created_at":    "2010-10-23T19:50:13Z",
    "updated_at":    "2011-04-04T00:33:57Z",
    "deleted_at":    null
  }]

Example

curl --digest -u arthur@dent.com:towel \
     -H "Accept: application/json" \
     "http://my.cl.ly/items?page=1&per_page=5"