Configuration and Content API Guide

Get CAL Packages

post

/config/sim/v1/setup/cal/getPackages

Gets a list of all CAL Packages in the specified organization

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

Objects included in the response.

Example: hierUnitId
includeAll: string

This can take 2 values: basic or detailed. If 'basic' is specified, The response contains all the properties of the object except Ext values. If 'detailed' is specified, The response contains all the properties of the object.

Example: detailed
languages: string

If specified, limits the translated strings returned.

Example: en-US, es-ES, es-MX
limit: integer

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

Example: 10
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: objectNum:asc
searchCriteria: string

Search criteria to filter results based on field value.

Example: where equals(objectNum,1)

{
    "type":"object",
    "properties":{
        "searchCriteria":{
            "type":"string",
            "example":"where equals(objectNum,1)",
            "description":"Search criteria to filter results based on field value."
        },
        "include":{
            "type":"string",
            "example":"hierUnitId",
            "description":"Objects included in the response."
        },
        "includeAll":{
            "type":"string",
            "example":"detailed",
            "description":"This can take 2 values: basic or detailed.\nIf 'basic' is specified, The response contains all the properties of the object except <options-string-name>Ext values.\nIf 'detailed' is specified, The response contains all the properties of the object. \n"
        },
        "languages":{
            "type":"string",
            "example":"en-US, es-ES, es-MX",
            "description":"If specified, limits the translated strings returned."
        },
        "offset":{
            "type":"integer",
            "example":0,
            "description":"Starting resource record index. Not required if paging parameters are not supported."
        },
        "limit":{
            "type":"integer",
            "example":10,
            "description":"If using paging, number of results returned in this page."
        },
        "orderBy":{
            "type":"string",
            "example":"objectNum:asc",
            "description":"Sorts the response by the specified field name and sort order."
        }
    }
}

Response

Supported Media Types

application/json

200 Response

A collection of CAL Packages.

Root Schema : CalPackageGetResponse

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 CAL Package 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 CAL Package objects of the organization.",
            "items":{
                "$ref":"#/definitions/CalPackage"
            }
        },
        "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 CAL Package objects of the organization.

Show Source

Array of: object CalPackage

Model for an CAL Package Object

{
    "type":"array",
    "description":"Array of CAL Package objects of the organization.",
    "items":{
        "$ref":"#/definitions/CalPackage"
    }
}

Nested Schema : CalPackage

Type: object

Model for an CAL Package Object

Show Source

deploymentOrder: integer

Deployment Order of the package. Enter a number that prioritizes the order of package downloads. CAL Packages with a value of 0 are loaded before packages with a value of 1.

Example: 20
limitOptions: string

A string value of 0s & 1s of length 8 representing the deployment of the CAL package to service hosts. If no service host is specified, then the package gets deployed to all service hosts

Example: 00000000
limitOptionsExt: object limitOptionsExt

An object containing the descriptive service hosts list where the package can be deployed
packageId: integer

Unique reference of the CAL package

Example: 1
packageName: string

Name of the package

Example: CAPSOnISS
platformType: integer

The type of platform that receives the CAL Package

Example: 20
version: string

Version of the package

Example: 19.3.3

{
    "description":"Model for an CAL Package Object",
    "type":"object",
    "properties":{
        "packageId":{
            "description":"Unique reference of the CAL package",
            "type":"integer",
            "example":1
        },
        "packageName":{
            "description":"Name of the package",
            "type":"string",
            "example":"CAPSOnISS"
        },
        "version":{
            "description":"Version of the package",
            "type":"string",
            "example":"19.3.3"
        },
        "deploymentOrder":{
            "description":"Deployment Order of the package. Enter a number that prioritizes the order of package downloads. CAL Packages with a value of 0 are loaded before packages with a value of 1.",
            "type":"integer",
            "example":20
        },
        "platformType":{
            "description":"The type of platform that receives the CAL Package",
            "type":"integer",
            "example":20
        },
        "limitOptions":{
            "description":"A string value of 0s & 1s of length 8 representing the deployment of the CAL package to service hosts. If no service host is specified, then the package gets deployed to all service hosts",
            "type":"string",
            "example":"00000000"
        },
        "limitOptionsExt":{
            "description":"An object containing the descriptive service hosts list where the package can be deployed",
            "type":"object",
            "properties":{
                "checkAndPosting":{
                    "description":"A Boolean flag indicating to deploy package to Check and Posting related service host",
                    "type":"boolean",
                    "example":false
                },
                "checkAndPostingBackup":{
                    "description":"A Boolean flag indicating to deploy package to Check and Posting Backup related service host",
                    "type":"boolean",
                    "example":false
                },
                "creditCard":{
                    "description":"A Boolean flag indicating to deploy package to Credit Card related service host",
                    "type":"boolean",
                    "example":false
                },
                "interfaces":{
                    "description":"A Boolean flag indicating to deploy package to interfaces related service host",
                    "type":"boolean",
                    "example":false
                },
                "kdsController":{
                    "description":"A Boolean flag indicating to deploy package to KDS Controller related service host",
                    "type":"boolean",
                    "example":false
                },
                "kdsControllerBackup":{
                    "description":"A Boolean flag indicating to deploy package to KDS Controller Backup related service host",
                    "type":"boolean",
                    "example":false
                },
                "sim":{
                    "description":"A Boolean flag indicating to deploy package to SIM related service host",
                    "type":"boolean",
                    "example":false
                },
                "workstation":{
                    "description":"A Boolean flag indicating to deploy package to Workstation related service host",
                    "type":"boolean",
                    "example":false
                }
            }
        }
    }
}

Nested Schema : limitOptionsExt

Type: object

An object containing the descriptive service hosts list where the package can be deployed

Show Source

checkAndPosting: boolean

A Boolean flag indicating to deploy package to Check and Posting related service host

Example: false
checkAndPostingBackup: boolean

A Boolean flag indicating to deploy package to Check and Posting Backup related service host

Example: false
creditCard: boolean

A Boolean flag indicating to deploy package to Credit Card related service host

Example: false
interfaces: boolean

A Boolean flag indicating to deploy package to interfaces related service host

Example: false
kdsController: boolean

A Boolean flag indicating to deploy package to KDS Controller related service host

Example: false
kdsControllerBackup: boolean

A Boolean flag indicating to deploy package to KDS Controller Backup related service host

Example: false
sim: boolean

A Boolean flag indicating to deploy package to SIM related service host

Example: false
workstation: boolean

A Boolean flag indicating to deploy package to Workstation related service host

Example: false

{
    "description":"An object containing the descriptive service hosts list where the package can be deployed",
    "type":"object",
    "properties":{
        "checkAndPosting":{
            "description":"A Boolean flag indicating to deploy package to Check and Posting related service host",
            "type":"boolean",
            "example":false
        },
        "checkAndPostingBackup":{
            "description":"A Boolean flag indicating to deploy package to Check and Posting Backup related service host",
            "type":"boolean",
            "example":false
        },
        "creditCard":{
            "description":"A Boolean flag indicating to deploy package to Credit Card related service host",
            "type":"boolean",
            "example":false
        },
        "interfaces":{
            "description":"A Boolean flag indicating to deploy package to interfaces related service host",
            "type":"boolean",
            "example":false
        },
        "kdsController":{
            "description":"A Boolean flag indicating to deploy package to KDS Controller related service host",
            "type":"boolean",
            "example":false
        },
        "kdsControllerBackup":{
            "description":"A Boolean flag indicating to deploy package to KDS Controller Backup related service host",
            "type":"boolean",
            "example":false
        },
        "sim":{
            "description":"A Boolean flag indicating to deploy package to SIM related service host",
            "type":"boolean",
            "example":false
        },
        "workstation":{
            "description":"A Boolean flag indicating to deploy package to Workstation related service host",
            "type":"boolean",
            "example":false
        }
    }
}