getSite
get
/ccagent/v1/sites/{id}
Get Site. Get a site by ID. Optionally takes the x-ccasset-language header to get translated content in another language.
Request
Supported Media Types
- application/json
Path Parameters
- id
-
Type:
stringRequired:trueThe ID of the site.
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 : getSite_response
- additionalLocaleIds
-
Type:
arrayadditionalLocaleIdsAdditional locale IDs. - defaultBillingCountryId
-
Type:
stringDefault Billing Country ID. - defaultCatalog
-
Type:
stringDefault catalog id. - defaultLocaleId
-
Type:
stringThe default locale ID. - defaultPriceListGroup
-
Type:
stringDefault price list group id. - defaultShippingCountryId
-
Type:
stringDefault Shipping Country ID. - defaultSite
-
Type:
booleanIndicates if the site is a default site - description
-
Type:
stringSite description. - enabled
-
Type:
booleanIndicates if the site is enabled - id
-
Type:
stringID of the site. - longDescription
-
Type:
stringLong site description. - name
-
Type:
stringSite name. - noimage
-
Type:
stringSite specific no-image image - priceListGroupList
-
Type:
arraypriceListGroupListList of Price List Groups associated with the site including default Price List Group - productionURL
-
Type:
stringThe production base url for storefront. If set, this base url will be used for any absolute generated links e.g. sitemap urls - recommendationsHost
-
Type:
stringThe host name of the recommendations server. - recommendationsPort
-
Type:
stringThe port of the recommendations server - repositoryId
-
Type:
stringRepository ID of the site. - secondaryCurrency
-
Type:
stringCurrency used for calculating shipping and tax for loyalty. - siteTypes
-
Type:
arraysiteTypesList of site types supported by this site. Each site type has has to be one of the allowed siteType options (case sensitive).
Nested Schema : additionalLocaleIds
Nested Schema : priceListGroupList
Nested Schema : siteTypes
Type:
arrayList of site types supported by this site. Each site type has has to be one of the allowed siteType options (case sensitive).
-
Type:
string
Nested Schema : items
Type:
object- id
-
Type:
stringThe priceListGroup id associated with site. - repositoryId
-
Type:
stringThe priceListGroup id associated with the site.
Example application/json
{
"longDescription":null,
"priceListGroupList":[
{
"repositoryId":"defaultPriceGroup",
"id":"defaultPriceGroup"
}
],
"productionURL":"localhostSiteUS:8080",
"recommendationsHost":"some.machine.example.com",
"noimage":"/file/v3496256495527410201/general/19417364_10155381677403926_746513040903355218_o.jpg",
"description":"Commerce Cloud Site",
"secondaryCurrency":"USD",
"defaultPriceListGroup":{
"repositoryId":"defaultPriceGroup",
"id":"defaultPriceGroup"
},
"defaultCatalog":{
"repositoryId":"cloudLakeCatalog"
},
"defaultBillingCountryId":null,
"defaultShippingCountryId":null,
"enabled":true,
"siteTypes":[
"commerce"
],
"recommendationsPort":"8080",
"defaultLocaleId":"1",
"loyaltyPrograms":[
{
"programName":"Movie rewards",
"repositoryId":"siteUS_LP0001",
"associationDate":"2017-07-05T14:15:37.000Z",
"programId":"LP0001"
}
],
"repositoryId":"siteUS",
"name":"Commerce Cloud Site",
"additionalProductionURLs":[
],
"id":"siteUS",
"defaultSite":true,
"additionalLocaleIds":[
]
}
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|
|------------------|------------------|
|30012|Could not get site for the id|
|30011|Given Site id does not exist|
|30016|Site internal error.|
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:
{
"longDescription": null,
"priceListGroupList": [{
"repositoryId": "defaultPriceGroup",
"id": "defaultPriceGroup"
}],
"productionURL": "localhostSiteUS:8080",
"recommendationsHost": "some.recs.machine.example.com",
"noimage": "/file/v3496256495527410201/general/19417364_10155381677403926_746513040903355218_o.jpg",
"description": "Commerce Cloud Site",
"secondaryCurrency": "USD",
"defaultPriceListGroup": {
"repositoryId": "defaultPriceGroup",
"id": "defaultPriceGroup"
},
"defaultCatalog": {"repositoryId": "cloudLakeCatalog"},
"defaultBillingCountryId": null,
"defaultShippingCountryId": null,
"enabled": true,
"siteTypes": ["commerce"],
"recommendationsPort": "8080",
"defaultLocaleId": "1",
"loyaltyPrograms": [{
"programName": "Movie rewards",
"repositoryId": "siteUS_LP0001",
"associationDate": "2017-07-05T14:15:37.000Z",
"programId": "LP0001"
}],
"repositoryId": "siteUS",
"name": "Commerce Cloud Site",
"additionalProductionURLs": [],
"id": "siteUS",
"defaultSite": true,
"additionalLocaleIds": []
}