Configuration and Content API Guide

Get Custom Content

post

/content/sim/v2/setup/getCustomContent

Gets all the custom content

Request

Supported Media Types

application/json
multipart/form-data

The input Body model that needs to be given.

Root Schema : schema

Type: object

Show Source

include: string

If specified, limits the data returned to these fields.

Example: hierUnitId, objectNum, name
includeAll: string

If this value is specified, the include parameter is ignored.

Value Description

basic Forces the response to include all fields except option string details

detailed Forces the response to include all fields including option string details

Example: detailed
langIds: string

If specified, limits translated strings returned

Example: 1,2,3
limit: integer

If using paging, number of results returned in this page.

Example: 100
offset: integer

Starting resource record index. Not required if paging parameters are not supported

Example: 0
orderBy: string

Sorts the response by the specified field name and sort order.

Example: hierUnitId:asc
searchCriteria: string

If specified, returns records that match the criteria.

Example: where equals(hierUnitId, 7)

{
    "type":"object",
    "properties":{
        "searchCriteria":{
            "type":"string",
            "example":"where equals(hierUnitId, 7)",
            "description":"If specified, returns records that match the criteria."
        },
        "include":{
            "type":"string",
            "example":"hierUnitId, objectNum, name",
            "description":"If specified, limits the data returned to these fields."
        },
        "includeAll":{
            "type":"string",
            "example":"detailed",
            "description":"If this value is specified, the include parameter is ignored.\n<table>\n<tr>\n  <td><b>Value</b></td>\n  <td><b>Description</b></td>\n</tr>\n<tr>\n  <td>basic</td>\n  <td>Forces the response to include all fields except option string details</td>\n</tr>\n<tr>\n  <td>detailed</td>\n  <td>Forces the response to include all fields including option string details</td>\n</tr>\n</table>\n"
        },
        "langIds":{
            "type":"string",
            "description":"If specified, limits translated strings returned",
            "example":"1,2,3"
        },
        "offset":{
            "type":"integer",
            "description":"Starting resource record index. Not required if paging parameters are not supported",
            "example":0
        },
        "limit":{
            "type":"integer",
            "description":"If using paging, number of results returned in this page.",
            "example":100
        },
        "orderBy":{
            "type":"string",
            "description":"Sorts the response by the specified field name and sort order.",
            "example":"hierUnitId:asc"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

A Collection of Custom Content objects

Root Schema : schema

Type: object

Show Source

count: integer

Current response record count.

Example: 9
hasMore: boolean

Flag indicating if there are more objects to fetch.

Example: true
items: array items

Array of Custom Content objects of the organization.
limit: integer

Server page size

Example: 10
offset: integer

Starting resource record index

Example: 0
totalResults: integer

Total number of rows (excluding the paging parameters)

Example: 100

{
    "type":"object",
    "properties":{
        "totalResults":{
            "type":"integer",
            "example":100,
            "description":"Total number of rows (excluding the paging parameters)"
        },
        "hasMore":{
            "type":"boolean",
            "example":true,
            "description":"Flag indicating if there are more objects to fetch."
        },
        "count":{
            "type":"integer",
            "example":9,
            "description":"Current response record count."
        },
        "items":{
            "type":"array",
            "description":"Array of Custom Content objects of the organization.",
            "items":{
                "$ref":"#/definitions/CustomContentv2"
            }
        },
        "offset":{
            "type":"integer",
            "example":0,
            "description":"Starting resource record index"
        },
        "limit":{
            "type":"integer",
            "example":10,
            "description":"Server page size"
        }
    }
}

Nested Schema : items

Type: array

Array of Custom Content objects of the organization.

Show Source

Array of: object CustomContentv2

{
    "type":"array",
    "description":"Array of Custom Content objects of the organization.",
    "items":{
        "$ref":"#/definitions/CustomContentv2"
    }
}

Nested Schema : CustomContentv2

Type: object

Show Source

description: object description

A group of string objects representing the description of custom content in configured languages
filename: string

The name of the custom content file with extension

Example: ImageSpoons.jpg
filenameOrigin: string

the content file origin.

Example: C:\Program Files\Oracle Hospitality\EMCClient\OPIPayment.dll
hierUnitId: integer

Unique hierarchy unit value

Example: 1
hierUnitObjNum: integer

Hierarchy unit object number

Example: 1
id: integer

Unique reference of the content

Example: 1
name: string

The name of the content object

Example: Image Spoons
size: integer

the size of the custom content in bytes.

Example: Size: 12 kb, png: 100 x 100 px
target: string

A string value of 0's & 1's representing the platforms where the content is targeted

Example: 11111111111111111111111111111111
targetExt: object CustomContent_targetExt

An object containing the descriptive platforms list where the content can be targeted
type: integer

The file type for the custom content

Example: 9
url: object URL

The URL of the download API which needs to be used to download the actual content file. This is auto-generated and does not need to be provided during add/update calls.

{
    "type":"object",
    "properties":{
        "hierUnitId":{
            "type":"integer",
            "example":1,
            "description":"Unique hierarchy unit value"
        },
        "hierUnitObjNum":{
            "type":"integer",
            "example":1,
            "description":"Hierarchy unit object number"
        },
        "id":{
            "type":"integer",
            "example":1,
            "description":"Unique reference of the content"
        },
        "name":{
            "type":"string",
            "example":"Image Spoons",
            "description":"The name of the content object"
        },
        "description":{
            "description":"A group of string objects representing the description of custom content in configured languages",
            "type":"object",
            "example":{
                "1":"Image Spoons",
                "2":"Bild L??ffel",
                "3":"Cucharas de Imagen"
            }
        },
        "size":{
            "type":"integer",
            "example":"Size: 12 kb, png: 100 x 100 px",
            "description":"the size of the custom content in bytes."
        },
        "type":{
            "type":"integer",
            "example":9,
            "description":"The file type for the custom content"
        },
        "filenameOrigin":{
            "type":"string",
            "example":"C:\\Program Files\\Oracle Hospitality\\EMCClient\\OPIPayment.dll",
            "description":"the content file origin."
        },
        "target":{
            "type":"string",
            "example":"11111111111111111111111111111111",
            "description":"A string value of 0's & 1's representing the platforms where the content is targeted"
        },
        "targetExt":{
            "$ref":"#/definitions/CustomContent_targetExt"
        },
        "filename":{
            "type":"string",
            "example":"ImageSpoons.jpg",
            "description":"The name of the custom content file with extension"
        },
        "url":{
            "$ref":"#/definitions/URL"
        }
    }
}

Nested Schema : description

Type: object

A group of string objects representing the description of custom content in configured languages

Example:

{
    "1":"Image Spoons",
    "2":"Bild L??ffel",
    "3":"Cucharas de Imagen"
}

Nested Schema : CustomContent_targetExt

Type: object

An object containing the descriptive platforms list where the content can be targeted

Show Source

android: boolean

target the content on Android platform

Example: false
androidMC40: boolean

target the content on AndroidMC platform

Example: false
androidMTablet: boolean

target the content on AndroidMTablet platform

Example: false
linux: boolean

deploy package to KDS Controller related service host target the content on Linux platform

Example: false
win32: boolean

target the content on Win32 platform

Example: false

{
    "type":"object",
    "description":"An object containing the descriptive platforms list where the content can be targeted",
    "properties":{
        "win32":{
            "type":"boolean",
            "example":false,
            "description":"target the content on Win32 platform"
        },
        "androidMC40":{
            "type":"boolean",
            "example":false,
            "description":"target the content on AndroidMC platform"
        },
        "android":{
            "type":"boolean",
            "example":false,
            "description":"target the content on Android platform"
        },
        "androidMTablet":{
            "type":"boolean",
            "example":false,
            "description":"target the content on AndroidMTablet platform"
        },
        "linux":{
            "type":"boolean",
            "example":false,
            "description":"deploy package to KDS Controller related service host target the content on Linux platform"
        }
    }
}

Nested Schema : URL

Type: object

The URL of the download API which needs to be used to download the actual content file. This is auto-generated and does not need to be provided during add/update calls.

Show Source

endpoint: string

Example: https://abc.com/content/sim/v1/menuItems/downloadConsumerContent
params: object params

{
    "type":"object",
    "description":"The URL of the download API which needs to be used to download the actual content file. This is auto-generated and does not need to be provided during add/update calls.",
    "properties":{
        "params":{
            "$ref":"#/definitions/params"
        },
        "endpoint":{
            "type":"string",
            "example":"https://abc.com/content/sim/v1/menuItems/downloadConsumerContent"
        }
    }
}

Nested Schema : params

Type: object

Show Source

hierUnitId: integer

Unique reference of the hierarchy unit

Example: 2
imageIndex: integer

Number of the image. Values range from 1-10.

Example: 1
objectNum: integer

Object Number of the family group

Example: 1

{
    "type":"object",
    "properties":{
        "hierUnitId":{
            "description":"Unique reference of the hierarchy unit",
            "type":"integer",
            "example":2
        },
        "objectNum":{
            "description":"Object Number of the family group",
            "type":"integer",
            "example":1
        },
        "imageIndex":{
            "description":"Number of the image. Values range from 1-10.",
            "type":"integer",
            "example":1
        }
    }
}

Value	Description
basic	Forces the response to include all fields except option string details
detailed	Forces the response to include all fields including option string details