getSites
get
/ccadmin/v1/sites
Get Sites. Get the list of available sites.
Request
Supported Media Types
- application/json
Query Parameters
-
expand: boolean
Specify whether an expanded response must be served
-
includeHistorical: boolean
The historical sites flag, if you want historicalSites then make it true
-
production: boolean
If this flag is set to true, sites will be returned from production DB. It's default value is false
-
q: string
The search query string in SCIM format. Results will be filtered based on this query.
Header Parameters
-
X-CCAsset-Language: string
The asset language of the request
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : getSites_response
Type:
Show Source
object-
items:
array items
The list of available sites
-
limit:
integer
The limit
-
offset:
integer
The offset
-
sort:
array sort
Array having the order and property of sites.
-
total:
integer
The total count
-
totalResults:
integer
The total results count
Nested Schema : items
Type:
Show Source
object-
activeTheme:
string
The activeTheme for the site.
-
additionalLocaleIds:
array additionalLocaleIds
IDs of additional locales.
-
additionalProductionURLs:
array additionalProductionURLs
A list of additional production URLs (without schema). Currently, only plain hostnames are supported.
-
allowAlternateCurrency:
boolean
Allows the order to be paid in mixed currencies
-
allowedOriginMethods:
object allowedOriginMethods
Additional Properties Allowed: additionalPropertiesMap of hostname (key) and the allowed http methods (values) for that host.
-
defaultBillingCountryId:
string
The default billing country ID.
-
defaultCatalog:
object defaultCatalog
The default catalog for the site.
-
defaultLocaleId:
string
The ID for the default locale of the site.
-
defaultPriceListGroup:
object defaultPriceListGroup
The default PLG for the site.
-
defaultShippingCountryId:
string
The default shipping country ID.
-
defaultSite:
string
Whether this is the default site
-
description:
string
A description of the site.
-
enabled:
boolean
Whether the site is enabled
-
favicon:
string
The favorite icon URL.
-
id:
string
The repository ID of the site.
-
inventoryLocationId:
string
Defines which inventory this site should use by default.
-
inventoryLocations:
array inventoryLocations
The "inventoryLocations" field, defined as an array, enables users to link multiple inventory locations to a site. If the "inventoryLocations" array includes at least one element, the "inventoryLocationId" field is not considered.
-
longDescription:
string
A long description of the site.
-
loyaltyPrograms:
array loyaltyPrograms
List of loyalty programs associated with site.
-
name:
string
The name of the site.
-
noimage:
string
The no image icon URL.
-
paymentOption:
integer
The payment option for the site
-
payShippingInSecondaryCurrency:
boolean
Pay shipping charges in secondary currency
-
payTaxInSecondaryCurrency:
boolean
Pay tax in secondary currency
-
priceListGroupList:
array priceListGroupList
List of priceListGroups to be associated with site.
-
productionURL:
string
The production URL (without the scheme) of the server. Currently, only hostnames are support.
-
recommendationsHost:
string
The host name of the recommendations server.
-
recommendationsPort:
string
The port of the recommendations server.
-
repositoryId:
string
The repository ID of the site.
-
secondaryCurrency:
string
Currency used for calculating shipping and tax for loyalty.
-
shipFromAddress:
object shipFromAddress
The ship from address used for tax calculations.
-
siteTypes:
array siteTypes
The list of site types.
-
timeToLive:
integer
The timeToLive of the site
-
timezone:
string
The time zone for this site.
-
useDefaultSiteLocale:
boolean
Property to decide whether the site to render in default site locale or not.
Nested Schema : additionalProductionURLs
Type:
arrayA list of additional production URLs (without schema). Currently, only plain hostnames are supported.
Show Source
Nested Schema : allowedOriginMethods
Type:
objectAdditional Properties Allowed
Show Source
Map of hostname (key) and the allowed http methods (values) for that host.
Nested Schema : defaultCatalog
Type:
objectThe default catalog for the site.
Show Source
-
displayName:
string
The display name of the default catalog for the site.
-
id:
string
The ID of the default catalog for the site.
-
repositoryId:
string
The ID of the default catalog for the site.
Nested Schema : defaultPriceListGroup
Type:
objectThe default PLG for the site.
Show Source
-
active:
boolean
Whether the PLG is active
-
deleted:
boolean
Whether the PLG is deleted
-
id:
string
The priceListGroup id associated with the site.
-
repositoryId:
string
The priceListGroup id associated with the site.
Nested Schema : inventoryLocations
Type:
arrayThe "inventoryLocations" field, defined as an array, enables users to link multiple inventory locations to a site. If the "inventoryLocations" array includes at least one element, the "inventoryLocationId" field is not considered.
Show Source
Nested Schema : loyaltyPrograms
Type:
arrayList of loyalty programs associated with site.
Show Source
Nested Schema : priceListGroupList
Type:
arrayList of priceListGroups to be associated with site.
Show Source
Nested Schema : shipFromAddress
Type:
objectThe ship from address used for tax calculations.
Show Source
-
addressLine1:
string
Ship from address line 1
-
addressLine2:
string
Ship from address line 2
-
addressLine3:
string
Ship from address line 3
-
city:
string
Ship from city
-
country:
string
Ship from country
-
postalCode:
string
Ship from postal code
-
region:
string
Ship from region
Nested Schema : items
Type:
Show Source
object-
associationDate:
string
Association date of loyalty program to site.
-
programId:
string
Loyalty Program Id.
-
programName:
string
Name for loyalty program.
-
repositoryId:
string
The loyalty program id associated with the site.
Nested Schema : items
Type:
Show Source
object-
active:
boolean
Whether the PLG is active
-
deleted:
boolean
Whether the PLG is deleted
-
id:
string
The priceListGroup id associated with the site.
-
repositoryId:
string
The priceListGroup id associated with the site.
Nested Schema : items
Type:
Show Source
object-
order:
string
The sort order: either asc or desc.
-
property:
string
The property sorted on.
Example Response (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":"recs.atgsvcs.example.com",
"productionURL":"wakko:9080",
"favicon":null,
"useDefaultSiteLocale":false,
"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":[
"example.com"
],
"id":"site2",
"additionalLocaleIds":[
"3",
"4",
"5"
]
},
{
"priceListGroupList":[
{
"repositoryId":"defaultPriceGroup",
"id":"defaultPriceGroup"
}
],
"recommendationsHost":"recs.atgsvcs.example.com",
"productionURL":"wakko:9080",
"favicon":null,
"useDefaultSiteLocale":false,
"timezone":"america_newyork",
"allowAlternateCurrency":true,
"noimage":null,
"secondaryCurrency":"USD",
"defaultCatalog":{
"repositoryId":"cloudLakeCatalog"
},
"payShippingInSecondaryCurrency":true,
"defaultBillingCountryId":"AR",
"defaultShippingCountryId":null,
"siteTypes":[
"commerce"
],
"payTaxInSecondaryCurrency":true,
"recommendationsPort":"8080",
"defaultLocaleId":"1",
"repositoryId":"siteUS",
"name":"Commerce Cloud Site",
"additionalProductionURLs":[
"othersite.example.com"
],
"id":"siteUS",
"additionalLocaleIds":[
"3",
"4",
"5"
]
}
]
}
Default Response
The error response
Root Schema : errorModel
Type:
Show Source
object-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
errors:
array errors
An optional list of errors if multiple errors were encountered
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code
-
type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
arrayAn optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code