PublicItem Service REST APIs

Owned by Tom Jones
Last updated: Jan 24, 2013Version comment
3 min read

Brief Description

Unknown macro: {multi-excerpt-include}
For a full description, visit the Service Description and Assumptions page.

Assumptions

Unknown macro: {multi-excerpt-include}
For a complete list of assumptions, visit the Service Description and Assumptions page.

References

PublicItem Service Description and Assumptions

REST-based API

The PublicItem Service offers a REST-based Application Programming Interface (API) to CRUD (create, read, update, and delete) operations on individual PublicItem instances. These follow the Common model for CollectionSpace REST services.

PublicItem CRUD+L services

Create a PublicItem

Creates a new PublicItem record. Assigns a unique, service-specified /wiki/spaces/collectionspace/pages/666274321 to that PublicItem record. Follows standard Create model. See the documentation of the PublicItem schema, below. Example:
Create a PublicItem and Publish an Artifact
Read a PublicItem

Reads an existing PublicItem record, specified by its /wiki/spaces/collectionspace/pages/666274321. Follows standard Read model. See the documentation of the PublicItem schema, below. Example:
Read a PublicItem's Published Artifact

Reads an existing PublicItem's published artifact (an image, report, attachment, etc), specified by its /wiki/spaces/collectionspace/pages/666274321. Follows standard Read model. See the documentation of the PublicItem schema, below. Example:
Update a PublicItem

Updates an existing PublicItem record, specified by its /wiki/spaces/collectionspace/pages/666274321. Follows standard Update model. See the documentation of the PublicItem schema, below. Example:
Delete a PublicItem

Deletes an existing PublicItem record, specified by its /wiki/spaces/collectionspace/pages/666274321. Follows standard Delete model. Example:
List PublicItem instances

Lists existing PublicItem records, with summary information for each. Follows standard List model, with pagination support. See the documentation of the PublicItem-List schema, below. List supports the following common parameters for List results, pagination controls and query filters:

  • pgSz for page size
  • pgNum for page size

Examples:

Example Result:

PublicItem REST payload schemas

The schemas below are abbreviated, and are thus illustrative. For a full list of the fields that may potentially be present in payloads when creating, updating, or reading individual PublicItem records, please see the most recent PublicItem schema.

PublicItem instance schema

Create and Update should use something like the following XML payload.

Read results in the something like the following example XML payload.
PublicItem-List schema

List (and variants) will return something like the following XML payload: