Page Comparison

...

Endpoint ID:

9004

Method:

URL:

POST: /user/dp-key/{dp-key}/content/search
POST: /user/ext-key/{ext-key}/{ext-type}/content/search

dp-key dialogportal™ master key that uniquely identifies the account to find content for.

ext-key External key that uniquely identifies the account to find content for.

ext-type Type of external key

Request body:

A JSON object describing the search parameters.

Required fields:

tags An array of tags

Optional fields:

limit The maximum number of content to return. If omitted, "limit" is set to 1.

offset The offset in search results from where to return data. If omitted, "offset" is set to 0.

fromDate UTC date used to filter search results by the content "activeFrom" date if it exists, or otherwise the "created" date.

compare Used to filter the search results by content "value"preferPrivate When true, private content will be returned before public content. If omitted, "preferPrivate" is set to "false".

data

An array of data filters. All filters are applied, so the example below could be read as "data with key 'a' between 5.1 and 5.9, where there is no 'x' data"

key	The data key that is to be matched
compare	The comparison operator. Possible "compare" options are: = != < > <= >=

betweenDecimal

 empty notempty

compareValue1

value

String or decimal comparison value. Required

if "compare" is one of

= < > <= >= between

compareValue2 Decimal comparison value. Required if "compare" has value "between".

preferPrivate

When true, private content will be returned before public content. If omitted, "preferPrivate" is set to "false"

for all comparison operators except empty and notempty.

Note

String data values will only be compared with string filter values, and numeric data values will only be compared with numeric filter values. So ensure that numeric values are entered as numbers, i.e. 5.9 not "5.9".

Numeric values are not culture-specific. Use period "." as decimal separator, and do not use thousand separators.

Code Block

title	Example

{
   "tags": [ "tag1", "tag2" ],
   "preferPrivate": false,
   "fromDate": "2014-01-01T01:00Z",
   "limit": 2,
   "offset": 10,
   "data": [
      {
         "key": "a",
         "compare": "between>=",
         "compareValue1compareValue": 5.1
      },
   "compareValue2   {
         "key": "a",
         "compare": "<=",
         "compareValue": 5.9
      },
      {
         "key": "x",
         "compare": "isempty"
      }
   ]
}

Response body:

JSON data with an array of content. The result will also contain a "paging" object detailing the number of content items returned, the offset and whether there are more items than the ones returned.

Code Block

title	Example

{
   "content": [
      {                                        /* public content - no dpKey   */
         "tags": [ "tag1", "tag2" ],
         "content": "PGh0bWw+PGJvZHk+TW9yZSBIVE1MIGNvbnRlbnQ8L2JvZHk+PC9odG1sPg==",
         "contentType": "text/html",
         "content"data": {
            "width": "PGh0bWw+PGJvZHk+TW9yZSBIVE1MIGNvbnRlbnQ8L2JvZHk+PC9odG1sPg==300px",
            "createdheight": "2014-02-10T12:53:42Z50px",
            "valuea": 5.5,
            "b": 15
         },
         "created": "2014-02-10T12:53:42Z",
         "activeFrom": "2014-03-01T12:00:00Z",
         "activeTo": "2014-03-08T12:00:00Z"
      },
      {                                        /* private content - has dpKey */
         "dpKey": 12345,
         "tags": [ "tag1", "tag2", "tag3" ],
         "contentTypecontent": "text/htmlPGh0bWw+PGJvZHk+SFRNTCBjb250ZW50PC9ib2R5PjwvaHRtbD4=",
         "contentcontentType": "PGh0bWw+PGJvZHk+SFRNTCBjb250ZW50PC9ib2R5PjwvaHRtbD4=text/html",
         "createddata": {
           "2014-02-08T09:00:34Z" "a": 5.9
         },
         "valuecreated": 5.9"2014-02-08T09:00:34Z"
      }
   ],
   "paging": {
      "offset": 10,
      "count": 2,
      "more": true
   }
}

Status codes:

200

OK

404.1 User not found

404.2 External user could not be found

404.4

No Content found

Versions Compared

Old Version 7

New Version 8

Key