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:
string
Required:true
The ID of the site.
Header Parameters
- X-CCAsset-Language
-
Type:
string
The 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:
array
additionalLocaleIdsAdditional Properties Allowed:Additional Country ids. - additionalProductionURLs
-
Type:
array
additionalProductionURLsAdditional Properties Allowed:The array of additional production URLs - allowedOriginMethods
-
Type:
object
allowedOriginMethodsAdditional Properties Allowed:{ "type":"string" }
Map of hostname (key) and the allowed http methods (values) for that host. - billingCountries
-
Type:
array
billingCountriesAdditional Properties Allowed:The list of billing countries - contextRoot
-
Type:
string
The context root of the site - defaultAccessLevel
-
Type:
string
The default access level of the site - defaultBillingCountryId
-
Type:
string
Default Billing Country ID. - defaultCatalog
-
Type:
object
defaultCatalogAdditional Properties Allowed:The default catalog associated with the site - defaultListPriceList
-
Type:
object
defaultListPriceListAdditional Properties Allowed:The default list price list - defaultLocaleId
-
Type:
string
The default locale ID. - defaultPriceListGroup
-
Type:
object
defaultPriceListGroupAdditional Properties Allowed:The default price list group - defaultSalePriceList
-
Type:
object
defaultSalePriceListAdditional Properties Allowed:The default sale price list - defaultShippingCountryId
-
Type:
string
Default Shipping Country ID. - defaultShippingSurchargePriceList
-
Type:
object
defaultShippingSurchargePriceListAdditional Properties Allowed:The default shipping surcharge price list - description
-
Type:
string
Site description. - emailAddress
-
Type:
string
The email address of the author - enabled
-
Type:
boolean
Is the site currently enabled - endecaSiteId
-
Type:
string
The endeca site associated with this site - favicon
-
Type:
string
The URL of the favicon - id
-
Type:
string
Id of the site. - longDescription
-
Type:
string
Long site description. - masterCatalog
-
Type:
object
masterCatalogAdditional Properties Allowed:The master catalog for the site - maxCouponsPerOrder
-
Type:
integer
Maximum coupons allowed per order (null if not applicable) - name
-
Type:
string
Site name. - paymentGateways
-
Type:
array
paymentGatewaysAdditional Properties Allowed:The array of the payment gateway names - priceListGroupList
-
Type:
array
priceListGroupListAdditional Properties Allowed:List of Price List Groups associated with the site including default Price List Group - productionURL
-
Type:
string
The production base url for storefront. If set, this base url will be used for any absolute generated links e.g. sitemap urls - profileContextList
-
Type:
object
profileContextListAdditional Properties Allowed:The list of profile contexts - realmId
-
Type:
string
The realm id - recommendationsHost
-
Type:
string
The host name of the recommendations server. - recommendationsPort
-
Type:
string
The port of the recommendations server - repositoryId
-
Type:
string
Repository ID of the site. - secondaryCurrency
-
Type:
string
Currency used for calculating shipping and tax for loyalty. - sfVersion
-
Type:
string
The storefront version - siteDownURL
-
Type:
string
The site down URL - siteIcon
-
Type:
string
The URL of the site icon - siteTemplate
-
Type:
string
The site template name - siteTypes
-
Type:
array
siteTypesAdditional 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:
integer
The hold price time value in milliseconds. - type
-
Type:
string
The 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:
object
The default catalog associated with the site
- allRootCategories
-
Type:
array
allRootCategoriesAdditional Properties Allowed:The array of all root categories - repositoryId
-
Type:
string
The repository id of the catalog - rootCategories
-
Type:
array
rootCategoriesAdditional Properties Allowed:The root categories of the default catalog
Nested Schema : defaultListPriceList
Type:
object
The default list price list
- repositoryId
-
Type:
string
Repository id of the default sale price list
Nested Schema : defaultPriceListGroup
Type:
object
The default price list group
- active
-
Type:
boolean
true if priceListGroup is active otherwise false - currency
-
Type:
object
currencyAdditional Properties Allowed:The currency of the price list group - deleted
-
Type:
boolean
true if priceListGroup is deleted otherwise false - displayName
-
Type:
string
The display name of the price list group - id
-
Type:
string
The priceListGroup id associated with site. - locale
-
Type:
string
The locale associated with the price list group - repositoryId
-
Type:
string
The priceListGroup id associated with the site.
Nested Schema : defaultSalePriceList
Type:
object
The default sale price list
- repositoryId
-
Type:
string
Repository id of the default sale price list
Nested Schema : defaultShippingSurchargePriceList
Type:
object
The default shipping surcharge price list
- repositoryId
-
Type:
string
Repository id of the default sale price list
Nested Schema : masterCatalog
Type:
object
The master catalog for the site
- allRootCategories
-
Type:
array
allRootCategoriesAdditional Properties Allowed:The array of all root categories - repositoryId
-
Type:
string
The repository id of the catalog - rootCategories
-
Type:
array
rootCategoriesAdditional Properties Allowed:The root categories of the default catalog
Nested Schema : paymentGateways
Nested Schema : priceListGroupList
Nested Schema : profileContextList
Type:
object
The list of profile contexts
- repositoryId
-
Type:
string
The repository id of the profile context
Nested Schema : siteTypes
Type:
array
List 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:
string
The country code - displayName
-
Type:
string
The display name of the country - repositoryId
-
Type:
string
The repository id of the country
Nested Schema : allRootCategories
Nested Schema : rootCategories
Nested Schema : items
Type:
object
- active
-
Type:
boolean
Whether the category is active - categoryIdPaths
-
Type:
array
categoryIdPathsAdditional Properties Allowed:The ids of the paths associated with the category - categoryImages
-
Type:
array
categoryImagesAdditional Properties Allowed:The array of image URLs associated with the category - categoryPaths
-
Type:
array
categoryPathsAdditional Properties Allowed:The category paths of the category - childCategories
-
Type:
array
childCategoriesAdditional Properties Allowed:The array of child categories - creationDate
-
Type:
string
The ISO 8601 date representing the creation date of the category - description
-
Type:
string
The description of the category - displayName
-
Type:
string
The display name of the category - fixedParentCategories
-
Type:
array
fixedParentCategoriesAdditional Properties Allowed:The array of the fixed parent categories. - id
-
Type:
string
The id of the category - longDescription
-
Type:
string
The long description of the category - repositoryId
-
Type:
string
The repository id of the category - route
-
Type:
string
The 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:
string
The repository id of the child categories
Nested Schema : items
Type:
object
- repositoryId
-
Type:
string
The repository id of the child categories
Nested Schema : currency
Type:
object
The currency of the price list group
- currencyCode
-
Type:
string
The currency code - displayName
-
Type:
string
The display name of the currency - fractionalDigits
-
Type:
integer
The fractional digits allowed in the currency - numericCode
-
Type:
string
The numeric code representing the currency - repositoryId
-
Type:
string
The repository id of the currency - symbol
-
Type:
string
The symbol of the currency
Nested Schema : allRootCategories
Nested Schema : rootCategories
Nested Schema : items
Type:
object
- active
-
Type:
boolean
Whether the category is active - categoryIdPaths
-
Type:
array
categoryIdPathsAdditional Properties Allowed:The ids of the paths associated with the category - categoryImages
-
Type:
array
categoryImagesAdditional Properties Allowed:The array of image URLs associated with the category - categoryPaths
-
Type:
array
categoryPathsAdditional Properties Allowed:The category paths of the category - childCategories
-
Type:
array
childCategoriesAdditional Properties Allowed:The array of child categories - creationDate
-
Type:
string
The ISO 8601 date representing the creation date of the category - description
-
Type:
string
The description of the category - displayName
-
Type:
string
The display name of the category - fixedParentCategories
-
Type:
array
fixedParentCategoriesAdditional Properties Allowed:The array of the fixed parent categories - id
-
Type:
string
The id of the category - longDescription
-
Type:
string
The long description of the category - repositoryId
-
Type:
string
The repository id of the category - route
-
Type:
string
The 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:
string
The repository id of the child categories
Nested Schema : items
Type:
object
- repositoryId
-
Type:
string
The repository id of the child categories
Nested Schema : items
Type:
object
- active
-
Type:
boolean
true if priceListGroup is active otherwise false - currency
-
Type:
object
currencyAdditional Properties Allowed:The currency of the price list group - deleted
-
Type:
boolean
true if priceListGroup is deleted otherwise false - displayName
-
Type:
string
The display name of the price list group - id
-
Type:
string
The priceListGroup id associated with site. - locale
-
Type:
string
The locale associated with the price list group - repositoryId
-
Type:
string
The priceListGroup id associated with the site.
Nested Schema : currency
Type:
object
The currency of the price list group
- currencyCode
-
Type:
string
The currency code - displayName
-
Type:
string
The display name of the currency - fractionalDigits
-
Type:
integer
The fractional digits allowed in the currency - numericCode
-
Type:
string
The numeric code representing the currency - repositoryId
-
Type:
string
The repository id of the currency - symbol
-
Type:
string
The 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:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - errors
-
Type:
array
errorsAdditional Properties Allowed:An optional list of errors if multiple errors were encountered - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The HTTP status code - type
-
Type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object
- devMessage
-
Type:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The 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": [] }