Skip to content

API : Items

jimsafley edited this page Jun 3, 2013 · 16 revisions

GET item

Return data about the specified item.

Request

GET /items/:id

Response

{
  "id": 1,
  "url": "http://yourdomain.com/api/items/1",
  "item_type": {"id": 1, "url": "http://yourdomain.com/api/item_types/1", "name": "Text"},
  "collection": {"id": 1, "url": "http://yourdomain.com/api/collections/1"},
  "owner": {"id": 1, "url": "http://yourdomain.com/api/users/1"},
  "public": true,
  "featured": false,
  "added": "2013-03-27T08:17:37+00:00",
  "modified": "2013-04-21T15:05:07+00:00", 
  "files": {"count": 100, "url": "http://yourdomain.com/api/files?item=1"},
  "tags": [
    {
      "id": 1, 
      "url": "http://yourdomain.com/api/tags/1", 
      "name": "foo"
    }
  ],
  "element_texts": [
    {
      "html": false,
      "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
      "element_set": {"id": 1, "url": "http://yourdomain.com/api/element_sets/1", "name": "Dublin Core"},
      "element": {"id": 1, "url": "http://yourdomain.com/api/elements/1", "name": "Title"}
    }
  ]
}

GET items

Return data about items.

Request

GET /items

Parameters

  • collection: integer
  • item_type: integer
  • featured: boolean
  • public: boolean
  • added_since: string (ISO 8601)
  • modified_since: string (ISO 8601)
  • owner (user): integer

Response

An array of JSON item representations (see above).

POST item

Create a new item.

Request

POST /items
{
  "item_type": {"id": 1},
  "collection": {"id": 1},
  "public": true,
  "featured": false,
  "tags": [
    {"name": "foo"},
    {"name": "bar"} 
  ],
  "element_texts": [
    {
      "html": false,
      "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
      "element": {"id": 1}
    }
  ]
}

Response

Location: http://yourdomain.com/api/items/:id

An JSON representation of the newly created item (see above).

PUT item

Edit an existing item.

Request

PUT /items/:id
{
  "item_type": {"id": 1},
  "collection": {"id": 1},
  "public": true,
  "featured": false,
  "tags": [
    {"name": "foo"},
    {"name": "bar"} 
  ],
  "element_texts": [
    {
      "html": false,
      "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
      "element": {"id": 1}
    }
  ]
}

Response

An JSON representation of the newly edited item (see above).

DELETE item

Delete an item.

Request

DELETE /items/:id

Response

An 204 No Content response.

Clone this wiki locally