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 Properties Allowed:Additional Country ids. - additionalProductionURLs
-
Type:
arrayadditionalProductionURLsAdditional Properties Allowed:The array of additional production URLs - allowedOriginMethods
-
Type:
objectallowedOriginMethodsAdditional Properties Allowed:{ "type":"string" }Map of hostname (key) and the allowed http methods (values) for that host. - billingCountries
-
Type:
arraybillingCountriesAdditional Properties Allowed:The list of billing countries - contextRoot
-
Type:
stringThe context root of the site - defaultAccessLevel
-
Type:
stringThe default access level of the site - defaultBillingCountryId
-
Type:
stringDefault Billing Country ID. - defaultCatalog
-
Type:
objectdefaultCatalogAdditional Properties Allowed:The default catalog associated with the site - defaultListPriceList
-
Type:
objectdefaultListPriceListAdditional Properties Allowed:The default list price list - defaultLocaleId
-
Type:
stringThe default locale ID. - defaultPriceListGroup
-
Type:
objectdefaultPriceListGroupAdditional Properties Allowed:The default price list group - defaultSalePriceList
-
Type:
objectdefaultSalePriceListAdditional Properties Allowed:The default sale price list - defaultShippingCountryId
-
Type:
stringDefault Shipping Country ID. - defaultShippingSurchargePriceList
-
Type:
objectdefaultShippingSurchargePriceListAdditional Properties Allowed:The default shipping surcharge price list - description
-
Type:
stringSite description. - emailAddress
-
Type:
stringThe email address of the author - enabled
-
Type:
booleanIs the site currently enabled - endecaSiteId
-
Type:
stringThe endeca site associated with this site - favicon
-
Type:
stringThe URL of the favicon - id
-
Type:
stringId of the site. - longDescription
-
Type:
stringLong site description. - masterCatalog
-
Type:
objectmasterCatalogAdditional Properties Allowed:The master catalog for the site - maxCouponsPerOrder
-
Type:
integerMaximum coupons allowed per order (null if not applicable) - name
-
Type:
stringSite name. - paymentGateways
-
Type:
arraypaymentGatewaysAdditional Properties Allowed:The array of the payment gateway names - priceListGroupList
-
Type:
arraypriceListGroupListAdditional Properties Allowed:List 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 - profileContextList
-
Type:
objectprofileContextListAdditional Properties Allowed:The list of profile contexts - realmId
-
Type:
stringThe realm id - 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. - sfVersion
-
Type:
stringThe storefront version - siteDownURL
-
Type:
stringThe site down URL - siteIcon
-
Type:
stringThe URL of the site icon - siteTemplate
-
Type:
stringThe site template name - siteTypes
-
Type:
arraysiteTypesAdditional Properties Allowed:List of site types supported by this site. Each site type has to be one of the allowed siteType options (case sensitive) - timeToLive
-
Type:
integerThe hold price time value in milliseconds. - type
-
Type:
stringThe site type
Nested Schema : additionalLocaleIds
Nested Schema : additionalProductionURLs
Nested Schema : allowedOriginMethods
Type:
object-
Type:
string
Map of hostname (key) and the allowed http methods (values) for that host.
Nested Schema : billingCountries
Nested Schema : defaultCatalog
Type:
objectThe default catalog associated with the site
- allRootCategories
-
Type:
arrayallRootCategoriesAdditional Properties Allowed:The array of all root categories - repositoryId
-
Type:
stringThe repository id of the catalog - rootCategories
-
Type:
arrayrootCategoriesAdditional Properties Allowed:The root categories of the default catalog
Nested Schema : defaultListPriceList
Type:
objectThe default list price list
- repositoryId
-
Type:
stringRepository id of the default sale price list
Nested Schema : defaultPriceListGroup
Type:
objectThe default price list group
- active
-
Type:
booleantrue if priceListGroup is active otherwise false - currency
-
Type:
objectcurrencyAdditional Properties Allowed:The currency of the price list group - deleted
-
Type:
booleantrue if priceListGroup is deleted otherwise false - displayName
-
Type:
stringThe display name of the price list group - id
-
Type:
stringThe priceListGroup id associated with site. - locale
-
Type:
stringThe locale associated with the price list group - repositoryId
-
Type:
stringThe priceListGroup id associated with the site.
Nested Schema : defaultSalePriceList
Type:
objectThe default sale price list
- repositoryId
-
Type:
stringRepository id of the default sale price list
Nested Schema : defaultShippingSurchargePriceList
Type:
objectThe default shipping surcharge price list
- repositoryId
-
Type:
stringRepository id of the default sale price list
Nested Schema : masterCatalog
Type:
objectThe master catalog for the site
- allRootCategories
-
Type:
arrayallRootCategoriesAdditional Properties Allowed:The array of all root categories - repositoryId
-
Type:
stringThe repository id of the catalog - rootCategories
-
Type:
arrayrootCategoriesAdditional Properties Allowed:The root categories of the default catalog
Nested Schema : paymentGateways
Nested Schema : priceListGroupList
Nested Schema : profileContextList
Type:
objectThe list of profile contexts
- repositoryId
-
Type:
stringThe repository id of the profile context
Nested Schema : siteTypes
Type:
arrayList of site types supported by this site. Each site type has to be one of the allowed siteType options (case sensitive)
-
Type:
string
Nested Schema : items
Type:
object- countryCode
-
Type:
stringThe country code - displayName
-
Type:
stringThe display name of the country - repositoryId
-
Type:
stringThe repository id of the country
Nested Schema : allRootCategories
Nested Schema : rootCategories
Nested Schema : items
Type:
object- active
-
Type:
booleanWhether the category is active - categoryIdPaths
-
Type:
arraycategoryIdPathsAdditional Properties Allowed:The ids of the paths associated with the category - categoryImages
-
Type:
arraycategoryImagesAdditional Properties Allowed:The array of image URLs associated with the category - categoryPaths
-
Type:
arraycategoryPathsAdditional Properties Allowed:The category paths of the category - childCategories
-
Type:
arraychildCategoriesAdditional Properties Allowed:The array of child categories - creationDate
-
Type:
stringThe ISO 8601 date representing the creation date of the category - description
-
Type:
stringThe description of the category - displayName
-
Type:
stringThe display name of the category - fixedParentCategories
-
Type:
arrayfixedParentCategoriesAdditional Properties Allowed:The array of the fixed parent categories. - id
-
Type:
stringThe id of the category - longDescription
-
Type:
stringThe long description of the category - repositoryId
-
Type:
stringThe repository id of the category - route
-
Type:
stringThe route of the category
Nested Schema : categoryIdPaths
Nested Schema : categoryImages
Nested Schema : categoryPaths
Nested Schema : childCategories
Nested Schema : fixedParentCategories
Nested Schema : items
Type:
object- repositoryId
-
Type:
stringThe repository id of the child categories
Nested Schema : items
Type:
object- repositoryId
-
Type:
stringThe repository id of the child categories
Nested Schema : currency
Type:
objectThe currency of the price list group
- currencyCode
-
Type:
stringThe currency code - displayName
-
Type:
stringThe display name of the currency - fractionalDigits
-
Type:
integerThe fractional digits allowed in the currency - numericCode
-
Type:
stringThe numeric code representing the currency - repositoryId
-
Type:
stringThe repository id of the currency - symbol
-
Type:
stringThe symbol of the currency
Nested Schema : allRootCategories
Nested Schema : rootCategories
Nested Schema : items
Type:
object- active
-
Type:
booleanWhether the category is active - categoryIdPaths
-
Type:
arraycategoryIdPathsAdditional Properties Allowed:The ids of the paths associated with the category - categoryImages
-
Type:
arraycategoryImagesAdditional Properties Allowed:The array of image URLs associated with the category - categoryPaths
-
Type:
arraycategoryPathsAdditional Properties Allowed:The category paths of the category - childCategories
-
Type:
arraychildCategoriesAdditional Properties Allowed:The array of child categories - creationDate
-
Type:
stringThe ISO 8601 date representing the creation date of the category - description
-
Type:
stringThe description of the category - displayName
-
Type:
stringThe display name of the category - fixedParentCategories
-
Type:
arrayfixedParentCategoriesAdditional Properties Allowed:The array of the fixed parent categories - id
-
Type:
stringThe id of the category - longDescription
-
Type:
stringThe long description of the category - repositoryId
-
Type:
stringThe repository id of the category - route
-
Type:
stringThe route of the category
Nested Schema : categoryIdPaths
Nested Schema : categoryImages
Nested Schema : categoryPaths
Nested Schema : childCategories
Nested Schema : fixedParentCategories
Nested Schema : items
Type:
object- repositoryId
-
Type:
stringThe repository id of the child categories
Nested Schema : items
Type:
object- repositoryId
-
Type:
stringThe repository id of the child categories
Nested Schema : items
Type:
object- active
-
Type:
booleantrue if priceListGroup is active otherwise false - currency
-
Type:
objectcurrencyAdditional Properties Allowed:The currency of the price list group - deleted
-
Type:
booleantrue if priceListGroup is deleted otherwise false - displayName
-
Type:
stringThe display name of the price list group - id
-
Type:
stringThe priceListGroup id associated with site. - locale
-
Type:
stringThe locale associated with the price list group - repositoryId
-
Type:
stringThe priceListGroup id associated with the site.
Nested Schema : currency
Type:
objectThe currency of the price list group
- currencyCode
-
Type:
stringThe currency code - displayName
-
Type:
stringThe display name of the currency - fractionalDigits
-
Type:
integerThe fractional digits allowed in the currency - numericCode
-
Type:
stringThe numeric code representing the currency - repositoryId
-
Type:
stringThe repository id of the currency - symbol
-
Type:
stringThe symbol of the currency
Example application/json
{
"longDescription":null,
"priceListGroupList":[
{
"repositoryId":"defaultPriceGroup",
"id":"defaultPriceGroup"
}
],
"productionURL":"localhostSiteUS:8080",
"recommendationsHost":"pt-recs-app1.us.oracle.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:
arrayerrorsAdditional Properties Allowed:An 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": "pt-recs-app1.us.oracle.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": []
}