memonic

Item Resource

The Item resource represents individual Items on Memonic.

Resource URL: https://api.memonic.com/v2/users/{user_id}/items/{item_id}?apikey={yourkey}

MethodPurpose
GET Returns an Item.

GET

The GET method on the Item resource returns the contents of the Item.

Request

Query string parameters

ParamPurposeValidation
thumbnails A coma-separated list of images/thumbnails to return for the Item. The following three values can be used: original (image as extracted from the original page), coverflow (max. 168x168 pixels) and small (max. 60x60 pixels) Optional

Response

Status codes

The following response status codes can be returned.

CodeReason
200 All good. Response body is enclosed.
401 Not logged in or invalid Authorization header.
404 The Item was not found.

In case of a successful 200 response the following output is returned:

XML

<item>
  <attachments>
    <child order="0">
      <url>http://attachmentdata.example.com/example/foo.pdf</url>
    </child>
  </attachments>
  <link href="https://api.memonic.com/v2/users/user_id/items/d370be14-d815-492d-b515-cdb6bd50f4ac.xml" order="0" rel="self"/>
  <link href="http://mem.to/t/1phTt" order="1" rel="tinyurl"/>
  <permission>private</permission>
  <updated_at>2011-02-16T18:22:52</updated_at>
  <groups>
    <child order="0">
      <id>a_group_id</id>
    </child>
  </groups>
  <data>
    <body>Some &lt;strong&gt;content&lt;/strong&gt;</body>
    <source>http://www.example.com/</source>
    <title>The title of this Item</title>
    <screenshot.original>http://example.com/screenshot.png</screenshot.original>
    <screenshot.coverflow>http://memonicstatic.example.com/coverflow.png</screenshot.coverflow>
    <screenshot.small>http://memonicstatic.example.com/small.png</screenshot.small>
  </data>
  <id>d370be14-d815-492d-b515-cdb6bd50f4ac</id>
  <created_at>2011-02-16T18:22:40</created_at>
  <version>1</version>
  <sets>
    <child order="0">
      <id>__all__</id>
    </child>
    <child order="1">
      <id>__inbox__</id>
    </child>
  </sets>
  <type>item</type>
</item>

JSON

{
  "attachments": [
    {
      "url": "http://attachmentdata.example.com/example/foo.pdf"
    }
  ], 
  "permission": "private", 
  "type": "item", 
  "created_at": "2011-02-16T18:22:40", 
  "updated_at": "2011-02-18T13:59:59", 
  "tinyurl": "http://mem.to/t/1phTt", 
  "version": "1", 
  "groups": [
    {
      "id": "a_group_id"
    }
  ], 
  "sets": [
    {
      "id": "__all__"
    }, 
    {
      "id": "__inbox__"
    }
  ], 
  "data": {
    "body": "Some <strong>content</strong>", 
    "title": "The title of this Item", 
    "screenshot.small": "http://memonicstatic.example.com/coverflow.png", 
    "source": "http://www.example.com/", 
    "screenshot.original": "http://example.com/screenshot.png", 
    "screenshot.coverflow": "http://memonicstatic.example.com/coverflow.png"
  }, 
  "id": "d370be14-d815-492d-b515-cdb6bd50f4ac"
}