Gets a list of items selected by specifying their type and
handle.
Data types are freely defined data item categories, presented as string values. Handles are data item identifiers. Together they are used to identify individual data items.
| Name | Description | Type | Use |
|---|---|---|---|
| type | Type of data to be retrieved. | string |
required |
| handle | Data item identifier. Supports partial matches if full matches are not found. | string |
required |
| onSuccess | A callback function, which passes an array of the |
function |
required |
| onFailure | A callback function, called when illegal arguments are provided. It passes an error code, as defined in the Constants table in the Client Store article, and an error message. | function |
required |
As its call parameter, the onSuccess callback receives an array
of the result JSON objects, structured as follows:
{
type,
handle,
content,
url
}| Name | Description | Type |
|---|---|---|
| type | The type of data in a retrieved data item. | string |
| handle | Data item identifier. | string |
| content | The retrieved item's data string. Returned if the item returned is a data item. | string |
| url | The retrieved item's reference. Returned if the item returned is a binary item. | string |