getSites
get
/ccadmin/v1/sites
Get Sites. Get the list of available sites.
Request
Supported Media Types
- application/json
Query Parameters
- includeHistorical
-
Type:
booleanThe historical sites flag, if you want historicalSites then make it true- q
Type:stringThe search query string in SCIM format. Results will be filtered based on this query.
Header Parameters
- X-CCAsset-Language
-
Type:
stringThe asset language of the request
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : getSites_response
- items
-
Type:
arrayitemsThe list of available sites - startingIndex
-
Type:
integerThe starting index - totalNumberOfItems
-
Type:
integerThe total number of items.
Nested Schema : items
Type:
object- additionalLocaleIds
-
Type:
arrayadditionalLocaleIdsIDs of additional locales. - additionalProductionURLs
-
Type:
arrayadditionalProductionURLsA list of additional production URLs (without schema). Currently, only plain hostnames are supported. - defaultBillingCountryId
-
Type:
stringThe default billing country ID. - defaultCatalog
-
Type:
objectdefaultCatalogThe default catalog for the site. - defaultLocaleId
-
Type:
stringThe ID for the default locale of the site. - defaultShippingCountryId
-
Type:
stringThe default shipping country ID. - defaultSite
-
Type:
booleanIndicates is the site is a default site. - description
-
Type:
stringA description of the site. - enabled
-
Type:
booleanIndicates whether the site is enabled. - id
-
Type:
stringThe repository ID of the site. - longDescription
-
Type:
stringA long description of the site. - loyaltyPrograms
-
Type:
arrayloyaltyProgramsList of loyalty programs associated with site. - name
-
Type:
stringThe name of the site. - noimage
-
Type:
stringSite specific no-image image - priceListGroupList
-
Type:
arraypriceListGroupListList of priceListGroups to be associated with site. - productionURL
-
Type:
stringThe production URL (without the scheme) of the server. Currently, only hostnames are support. - recommendationsHost
-
Type:
stringThe host name of the recommendations server. - recommendationsPort
-
Type:
stringThe port of the recommendations server. - repositoryId
-
Type:
stringThe repository ID of the site. - secondaryCurrency
-
Type:
stringCurrency used for calculating shipping and tax for loyalty. - siteTypes
-
Type:
arraysiteTypesThe list of site types.
Nested Schema : additionalLocaleIds
Nested Schema : additionalProductionURLs
Type:
arrayA list of additional production URLs (without schema). Currently, only plain hostnames are supported.
-
Type:
string
Nested Schema : defaultCatalog
Type:
objectThe default catalog for the site.
- repositoryId
-
Type:
stringThe ID of the default catalog for the site.
Nested Schema : loyaltyPrograms
Nested Schema : priceListGroupList
Nested Schema : siteTypes
Nested Schema : items
Type:
object- associationDate
-
Type:
stringAssociation date of loyalty program to site. - programId
-
Type:
stringLoyalty Program Id. - programName
-
Type:
stringName for loyalty program. - repositoryId
-
Type:
stringThe loyalty program id associated with the site.
Nested Schema : items
Type:
object- id
-
Type:
stringThe priceListGroup id associated with the site. - repositoryId
-
Type:
stringThe priceListGroup id associated with the site.
Example application/json
{
"endingIndex":250,
"totalResultsParam":true,
"links":[
{
"rel":"self",
"href":"http://localhost:9080/ccadmin/v1/sites"
}
],
"sort":{
"collator":null,
"numDirectives":1,
"empty":false
},
"items":[
{
"priceListGroupList":[
{
"repositoryId":"defaultPriceGroup",
"id":"defaultPriceGroup"
}
],
"recommendationsHost":"some.recs.machine.us.example.com",
"productionURL":"wakko:9080",
"favicon":null,
"timezone":"europe_london",
"noimage":null,
"defaultCatalog":{
"repositoryId":"cloudLakeCatalog"
},
"defaultBillingCountryId":"AR",
"defaultShippingCountryId":null,
"siteTypes":[
"commerce"
],
"recommendationsPort":"8080",
"defaultLocaleId":"1",
"repositoryId":"site2",
"name":"Commerce Cloud Site",
"additionalProductionURLs":[
"mysite.com"
],
"id":"site2",
"additionalLocaleIds":[
"3",
"4",
"5"
]
},
{
"priceListGroupList":[
{
"repositoryId":"defaultPriceGroup",
"id":"defaultPriceGroup"
}
],
"recommendationsHost":"some.recs.machine.example.com",
"productionURL":"wakko:9080",
"favicon":null,
"timezone":"america_newyork",
"noimage":null,
"secondaryCurrency":"USD",
"defaultCatalog":{
"repositoryId":"cloudLakeCatalog"
},
"defaultBillingCountryId":"AR",
"defaultShippingCountryId":null,
"siteTypes":[
"commerce"
],
"recommendationsPort":"8080",
"defaultLocaleId":"1",
"repositoryId":"siteUS",
"name":"Commerce Cloud Site",
"additionalProductionURLs":[
"othersite.com"
],
"id":"siteUS",
"additionalLocaleIds":[
"3",
"4",
"5"
]
}
],
"startingIndex":0,
"totalNumberOfItems":2
}
Default Response
The error response
Body
Root Schema : errorModel
Type:
object- devMessage
-
Type:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - errors
-
Type:
arrayerrorsAn optional list of errors if multiple errors were encountered - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe HTTP status code - type
-
Type:
stringThe URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object- devMessage
-
Type:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe HTTP status code
Examples
Sample Response Payload returned by endpoint:
{
"endingIndex": 250,
"totalResultsParam": true,
"links": [{
"rel": "self",
"href": "http://localhost:9080/ccadmin/v1/sites"
}],
"sort": {
"collator": null,
"numDirectives": 1,
"empty": false
},
"items": [
{
"priceListGroupList": [{
"repositoryId": "defaultPriceGroup",
"id": "defaultPriceGroup"
}],
"recommendationsHost": "some.recs.machine.us.example.com",
"productionURL": "wakko:9080",
"favicon": null,
"timezone": "europe_london",
"noimage": null,
"defaultCatalog": {"repositoryId": "cloudLakeCatalog"},
"defaultBillingCountryId": "AR",
"defaultShippingCountryId": null,
"siteTypes": ["commerce"],
"recommendationsPort": "8080",
"defaultLocaleId": "1",
"repositoryId": "site2",
"name": "Commerce Cloud Site",
"additionalProductionURLs": ["mysite.com"],
"id": "site2",
"additionalLocaleIds": [
"3",
"4",
"5"
]
},
{
"priceListGroupList": [{
"repositoryId": "defaultPriceGroup",
"id": "defaultPriceGroup"
}],
"recommendationsHost": "some.recs.machine.example.com",
"productionURL": "wakko:9080",
"favicon": null,
"timezone": "america_newyork",
"noimage": null,
"secondaryCurrency": "USD",
"defaultCatalog": {"repositoryId": "cloudLakeCatalog"},
"defaultBillingCountryId": "AR",
"defaultShippingCountryId": null,
"siteTypes": ["commerce"],
"recommendationsPort": "8080",
"defaultLocaleId": "1",
"repositoryId": "siteUS",
"name": "Commerce Cloud Site",
"additionalProductionURLs": ["othersite.com"],
"id": "siteUS",
"additionalLocaleIds": [
"3",
"4",
"5"
]
}
],
"startingIndex": 0,
"totalNumberOfItems": 2
}