1. REST API for Oracle Commerce Cloud December 2017
  2. Tasks
  3. Store
  4. Profiles

updateSiteProperties

put

/ccstore/v1/profiles/current/siteProperties

Updates the site based properties for the current profile. Can be used to update multiple properties of multiple sites at the same time.

Request

Supported Media Types
  • application/json
Query Parameters
limit
Type: integer
This is the field to specify the number of records to be fetched per REST call.
offset
Type: integer
This field specifies the offset/starting index from which data to be fetched.
Header Parameters
X-CCAsset-Language
Type: string
The asset language of the request.
Body Parameter
Root Schema : updateSiteProperties_request
Nested Schema : siteProperties
Type: array
The site related properties
Nested Schema : items
Type: object
Nested Schema : properties
Type: object
The site related properties to be updated for the profile
Nested Schema : site
Type: object
The site data

Response

Supported Media Types
  • application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : updateSiteProperties_response
Nested Schema : items
Type: array
The list of site related properties for the profile
Nested Schema : items
Type: object
Nested Schema : properties
Type: object
The site related properties for the profile
Nested Schema : site
Type: object
The site data
Example application/json

{
    "totalResults":2,
    "endingIndex":250,
    "offset":0,
    "totalResultsParam":true,
    "count":2,
    "limit":250,
    "links":[
        {
            "rel":"self",
            "href":"http://localhost:8080/ccstoreui/v1/profiles/current/siteProperties"
        }
    ],
    "sort":null,
    "items":[
        {
            "site":{
                "repositoryId":"100001",
                "id":"100001"
            },
            "properties":{
                "repositoryId":"100002",
                "receiveEmail":"no"
            }
        },
        {
            "site":{
                "id":"siteUS"
            },
            "properties":{
                "receiveEmail":"yes"
            }
        }
    ],
    "listingRequest":{
        "endingIndex":250,
        "correctedView":null,
        "queryOptions":{
            "precachedPropertyNames":null,
            "doNotCacheQuery":false,
            "sortDirectives":null,
            "endingIndex":250,
            "ignoreDuplicates":false,
            "nthIndex":1,
            "uncachedItems":false,
            "uncachedItemsSet":false,
            "startingIndex":0
        },
        "rqlString":null,
        "QErrorCodeMap":null,
        "QPropertyAliasMap":null,
        "sort":null,
        "startingIndex":0,
        "QIgnoreCase":true,
        "QString":null,
        "filterProperties":[
            "displayName",
            "id"
        ],
        "includeRqlInQueryGeneration":true,
        "rqlStatement":null,
        "expanded":false,
        "scimParser":null,
        "useSCIMForQ":true,
        "limit":250,
        "siteId":"siteUS",
        "after":null,
        "calculateTotalAvailable":true
    },
    "startingIndex":0,
    "totalNumberOfItems":2
}
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| |------------------|------------------| |22031|Internal error during get profile properties.| |22032|Error occured due to invalid data| |22033|User is not logged in.| |22034|No site found| |22035|Error occured when site property not found.| |22036|Internal error during update profile properties.|
Body
Root Schema : errorModel
Type: object
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Nested Schema : items
Type: object

Examples

Sample Request:

{"siteProperties": [
  {
    "site": {"id": "100001"},
    "properties": {"receiveEmail": "no"}
  },
  {
    "site": {"id": "siteUS"},
    "properties": {"receiveEmail": "yes"}
  }
]}

Sample Response Payload returned by endpoint:

{
  "totalResults": 2,
  "endingIndex": 250,
  "offset": 0,
  "totalResultsParam": true,
  "count": 2,
  "limit": 250,
  "links": [{
    "rel": "self",
    "href": "http://localhost:8080/ccstoreui/v1/profiles/current/siteProperties"
  }],
  "sort": null,
  "items": [
    {
      "site": {
        "repositoryId": "100001",
        "id": "100001"
      },
      "properties": {
        "repositoryId": "100002",
        "receiveEmail": "no"
      }
    },
    {
      "site": {"id": "siteUS"},
      "properties": {"receiveEmail": "yes"}
    }
  ],
  "listingRequest": {
    "endingIndex": 250,
    "correctedView": null,
    "queryOptions": {
      "precachedPropertyNames": null,
      "doNotCacheQuery": false,
      "sortDirectives": null,
      "endingIndex": 250,
      "ignoreDuplicates": false,
      "nthIndex": 1,
      "uncachedItems": false,
      "uncachedItemsSet": false,
      "startingIndex": 0
    },
    "rqlString": null,
    "QErrorCodeMap": null,
    "QPropertyAliasMap": null,
    "sort": null,
    "startingIndex": 0,
    "QIgnoreCase": true,
    "QString": null,
    "filterProperties": [
      "displayName",
      "id"
    ],
    "includeRqlInQueryGeneration": true,
    "rqlStatement": null,
    "expanded": false,
    "scimParser": null,
    "useSCIMForQ": true,
    "limit": 250,
    "siteId": "siteUS",
    "after": null,
    "calculateTotalAvailable": true
  },
  "startingIndex": 0,
  "totalNumberOfItems": 2
}