REST API for Oracle Commerce Cloud December 2017

listSiteSettings

get

/ccadmin/v1/sitesettings

List Site Settings. Gets all site settings by ID.

Request

There are no request parameters for this operation.

Response

Supported Media Types

application/json

200 Response

Following model is returned when operation succeeds.

Body

Root Schema : listSiteSettings_response

Properties

description: Type: string

Description of the settings item.
displayName: Type: string

Display name of the settings item.
id: Type: string

ID of the site settings extension.
repositoryId: Type: string

Repository ID of the settings item.
values: Type: array values

Additional Properties Allowed:

Array of sites configuration items.

Nested Schema : values

Type: array

Array of sites configuration items.

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

defaultValue: Type: string

The default value of the configuration item
helpText: Type: string

The help text to be display against the configuration item
label: Type: string

The label to be display for the configuration item
maxLength: Type: integer

The maximum length of the configuration item
minLength: Type: integer

The minimum length of the configuration item
name: Type: string

The name the configuration item
options: Type: array options

Additional Properties Allowed:

Array of options for an option type
regexText: Type: string

Repository ID
repositoryId: Type: string

Repository ID
required: Type: string

If the configuration item is required or not
type: Type: string

The type of the configuration value e.g string, option

Nested Schema : options

Type: array

Array of options for an option type

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

label: Type: string

The text to be displayed on the option
repositoryId: Type: string

Repository ID
value: Type: integer

The option value

Example application/json


[
    {
        "values":[
            {
                "helpText":"Enable the cart message.",
                "defaultValue":"true",
                "minLength":0,
                "name":"enabled",
                "repositoryId":"100005",
                "options":[
                ],
                "regexText":null,
                "label":"Enable",
                "type":"checkbox",
                "maxLength":1000,
                "required":false
            },
            {
                "helpText":"Define the coupon name.",
                "defaultValue":"SHIP100",
                "minLength":6,
                "name":"coupon",
                "repositoryId":"100006",
                "options":[
                ],
                "regexText":null,
                "label":"Coupon",
                "type":"text",
                "maxLength":10,
                "required":true
            },
            {
                "helpText":"Define the minimum spend for the coupon.",
                "defaultValue":"100",
                "minLength":0,
                "name":"minSpend",
                "repositoryId":"100007",
                "options":[
                ],
                "regexText":null,
                "label":"Minimum Spend",
                "type":"text",
                "maxLength":1000,
                "required":true
            },
            {
                "helpText":"Set the value for API key.",
                "defaultValue":null,
                "minLength":0,
                "name":"password",
                "repositoryId":"100008",
                "options":[
                ],
                "regexText":null,
                "label":"API Key",
                "type":"password",
                "maxLength":1000,
                "required":true
            },
            {
                "helpText":"The size of the banner.",
                "defaultValue":"s",
                "minLength":0,
                "name":"bannerSize",
                "repositoryId":"100009",
                "options":[
                    {
                        "repositoryId":"100006",
                        "label":"Small",
                        "value":"s"
                    },
                    {
                        "repositoryId":"100007",
                        "label":"Medium",
                        "value":"m"
                    },
                    {
                        "repositoryId":"100008",
                        "label":"Large",
                        "value":"l"
                    }
                ],
                "regexText":null,
                "label":"Banner Size",
                "type":"option",
                "maxLength":1000,
                "required":true
            }
        ],
        "id":"settingsdemo"
    },
    {
        "displayName":"Settings 1",
        "values":[
            {
                "helpText":"Enable the cart message.",
                "defaultValue":"true",
                "minLength":0,
                "name":"enabled",
                "repositoryId":"100005",
                "options":[
                ],
                "regexText":null,
                "label":"Enable",
                "type":"checkbox",
                "maxLength":1000,
                "required":false
            },
            {
                "helpText":"Define the coupon name.",
                "defaultValue":"SHIP100",
                "minLength":6,
                "name":"coupon",
                "repositoryId":"100006",
                "options":[
                ],
                "regexText":null,
                "label":"Coupon",
                "type":"text",
                "maxLength":10,
                "required":true
            }
        ],
        "repositoryId":"settings1",
        "description":"Sample Setting.",
        "id":"setting1"
    }
]

Default Response

The error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud: |Error Code|Description| |------------------|------------------| |33032|Error retrieving all site settings|

Body

Root Schema : errorModel

Type: object

Properties

devMessage: Type: string

An optional non-localized message containing technical information for developers
errorCode: Type: string

The numerical code identifying the error
errors: Type: array errors

Additional Properties Allowed:

An optional list of errors if multiple errors were encountered
message: Type: string

The localized message describing the error
moreInfo: Type: string

An optional non-localized message with more information
o:errorPath: Type: string

An optional machine readable description of where the error occurred
status: Type: string

The HTTP status code
type: Type: string

The URI to the HTTP state code definition

Nested Schema : errors

Type: array

An optional list of errors if multiple errors were encountered

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

devMessage: Type: string

An optional non-localized message containing technical information for developers
errorCode: Type: string

The numerical code identifying the error
message: Type: string

The localized message describing the error
moreInfo: Type: string

An optional non-localized message with more information
o:errorPath: Type: string

An optional machine readable description of where the error occurred
status: Type: string

The HTTP status code

Examples

Sample Response Payload returned by endpoint:

[
  {
    "values": [
      {
        "helpText": "Enable the cart message.",
        "defaultValue": "true",
        "minLength": 0,
        "name": "enabled",
        "repositoryId": "100005",
        "options": [],
        "regexText": null,
        "label": "Enable",
        "type": "checkbox",
        "maxLength": 1000,
        "required": false
      },
      {
        "helpText": "Define the coupon name.",
        "defaultValue": "SHIP100",
        "minLength": 6,
        "name": "coupon",
        "repositoryId": "100006",
        "options": [],
        "regexText": null,
        "label": "Coupon",
        "type": "text",
        "maxLength": 10,
        "required": true
      },
      {
        "helpText": "Define the minimum spend for the coupon.",
        "defaultValue": "100",
        "minLength": 0,
        "name": "minSpend",
        "repositoryId": "100007",
        "options": [],
        "regexText": null,
        "label": "Minimum Spend",
        "type": "text",
        "maxLength": 1000,
        "required": true
      },
      {
        "helpText": "Set the value for API key.",
        "defaultValue": null,
        "minLength": 0,
        "name": "password",
        "repositoryId": "100008",
        "options": [],
        "regexText": null,
        "label": "API Key",
        "type": "password",
        "maxLength": 1000,
        "required": true
      },
      {
        "helpText": "The size of the banner.",
        "defaultValue": "s",
        "minLength": 0,
        "name": "bannerSize",
        "repositoryId": "100009",
        "options": [
          {
            "repositoryId": "100006",
            "label": "Small",
            "value": "s"
          },
          {
            "repositoryId": "100007",
            "label": "Medium",
            "value": "m"
          },
          {
            "repositoryId": "100008",
            "label": "Large",
            "value": "l"
          }
        ],
        "regexText": null,
        "label": "Banner Size",
        "type": "option",
        "maxLength": 1000,
        "required": true
      }
    ],
    "id": "settingsdemo"
  },
  {
    "displayName": "Settings 1",
    "values": [
      {
        "helpText": "Enable the cart message.",
        "defaultValue": "true",
        "minLength": 0,
        "name": "enabled",
        "repositoryId": "100005",
        "options": [],
        "regexText": null,
        "label": "Enable",
        "type": "checkbox",
        "maxLength": 1000,
        "required": false
      },
      {
        "helpText": "Define the coupon name.",
        "defaultValue": "SHIP100",
        "minLength": 6,
        "name": "coupon",
        "repositoryId": "100006",
        "options": [],
        "regexText": null,
        "label": "Coupon",
        "type": "text",
        "maxLength": 10,
        "required": true
      }
    ],
    "repositoryId": "settings1",
    "description": "Sample Setting.",
    "id": "setting1"
  }
]