REST API for Oracle Commerce Cloud

getPage

get

/ccagent/v1/pages/{path: .*}

Get Page. Returns a specific page. For product/category page responses, productTypes information is also returned as part of the data->page response.

Request

Supported Media Types

application/json

Path Parameters

path: .*(required): string

Query Parameters

cacheableDataOnly: string

Boolean flag to set whether to only cacheable data (for example cacheableDataOnly=true). It can be used only if dataOnly is false.
currentDataOnly: string

Boolean flag to set whether to only return current data (for example currentDataOnly=true). It can be used only if dataOnly is false.
dataOnly: string

Boolean flag to set whether to only return data (for example dataOnly=false).
layoutOnly: string

Boolean flag to set whether to only return layout data (for example layoutOnly=true). It can be used only if dataOnly is false.
pageParam: string

Page param (for example pageParam=cat90016).
productTypesRequired: string

Boolean flag to indicate whether productTypes data is needed in the response. This parameter will be useful only on product and category pages, as productTypes is currently returned in those pages.

Response

Supported Media Types

application/json

200 Response

Following model is returned when operation succeeds.

Root Schema : getPage_response

Type: object

Show Source

canonicalRoute: string

The canonical route for home, article, product and category pages.
description: string

The page description.
isPreview: boolean

Whether the server is in preview mode.
keywords: string

The keywords for the page.
regions: array regions

The region data for all the regions of a page.
route: string

The page route.
title: string

The page title.

{
    "properties":{
        "route":{
            "description":"The page route.",
            "type":"string"
        },
        "regions":{
            "description":"The region data for all the regions of a page.",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                }
            }
        },
        "keywords":{
            "description":"The keywords for the page.",
            "type":"string"
        },
        "isPreview":{
            "description":"Whether the server is in preview mode.",
            "type":"boolean"
        },
        "canonicalRoute":{
            "description":"The canonical route for home, article, product and category pages.",
            "type":"string"
        },
        "description":{
            "description":"The page description.",
            "type":"string"
        },
        "title":{
            "description":"The page title.",
            "type":"string"
        }
    }
}

Nested Schema : regions

Type: array

The region data for all the regions of a page.

Show Source

Array of: object items

{
    "description":"The region data for all the regions of a page.",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
        }
    }
}

Nested Schema : items

Type: object

Show Source

{
    "type":"object",
    "properties":{
    }
}

Example Response (application/json)

{
    "route":"/category",
    "regions":[
        {
            "width":12,
            "name":"productListingRegion",
            "widgets":[
                {
                    "customTranslations":{
                    },
                    "localeResources":{
                        "en":{
                            "namespace":"ns.productlisting",
                            "resources":{
                                "goToPageText":"Go to page",
                                "viewingOptionsText":"Viewing options",
                                "dYMTermText":"\"__label__\"",
                                "goToPreviousPageText":"Go to previous page",
                                "resultsText":"Results: __startIndex__ - __endIndex__ (of __totalProducts__)",
                                "priceRangeText":"Price Range",
                                "viewByText":"View By:",
                                "salePriceText":"Sale price",
                                "sortByText":"Sort By:",
                                "onSaleText":"Sale",
                                "goToLastPageText":"Go to last page",
                                "matchingProductsText":"Matching products",
                                "listViewLoadedText":"Collection page displayed in list view",
                                "goToNextPageText":"Go to next page",
                                "dYMTermTextHasNext":"\"__label__\", ",
                                "sortByPriceDescText":"Price high to low",
                                "listText":"List",
                                "didYouMeanText":"Did you mean? ",
                                "gridText":"Grid",
                                "dYMTermAriaLabel":"Alternative search suggestions",
                                "sortByPriceAscText":"Price low to high",
                                "clickToViewText":"Click to view page ",
                                "activePageText":"Active page is ",
                                "returnedResultsText":" Returned results",
                                "searchResultsText":"Search results",
                                "wasText":"Was",
                                "sortByRelevanceText":"Default",
                                "goToFirstPageText":"Go to first page",
                                "refineResultsText":"Refine results",
                                "listPriceText":"List price",
                                "toText":"To",
                                "gridViewLoadedText":"Collection page displayed in grid view"
                            }
                        }
                    },
                    "hidden":null,
                    "isPreview":true,
                    "numberOnPage":1,
                    "instanceName":"Product Listing Widget",
                    "displayName":"Product Listing",
                    "global":null,
                    "locale":"en",
                    "listType":"product",
                    "shouldUseStyleBased":"true",
                    "pages":[
                        "category"
                    ],
                    "elementsSrc":"",
                    "id":"productListingInst",
                    "imports":[
                        "site",
                        "category",
                        "categoryId",
                        "cart",
                        "links",
                        "productTypes",
                        "passwordPolicies",
                        "user",
                        "dimensionId"
                    ],
                    "i18nresources":"productlisting",
                    "assetMappings":{
                        "/locales/ru/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/ru/ns.productlisting.json",
                        "/locales/pt/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/pt/ns.productlisting.json",
                        "/locales/nl/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/nl/ns.productlisting.json",
                        "/locales/ja/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/ja/ns.productlisting.json",
                        "/fragments/all-fragments.template":"http://localhost:9080/file/v1/widget/productListing/fragments/all-fragments.template",
                        "/less/widget.less":"http://localhost:9080/file/widget/productListing/less/widget.less",
                        "/locales/cs/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/cs/ns.productlisting.json",
                        "/locales/zh-TW/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/zh-TW/ns.productlisting.json",
                        "/locales/fi/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/fi/ns.productlisting.json",
                        "/templates/display.template":"http://localhost:9080/file/widget/productListing/templates/display.template",
                        "/locales/ko/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/ko/ns.productlisting.json",
                        "/locales/it/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/it/ns.productlisting.json",
                        "/locales/pt-BR/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/pt-BR/ns.productlisting.json",
                        "/locales/el/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/el/ns.productlisting.json",
                        "/locales/fr/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/fr/ns.productlisting.json",
                        "/config/config.json":"http://localhost:9080/file/widget/productListing/config/config.json",
                        "/locales/en/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/en/ns.productlisting.json",
                        "/locales/th/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/th/ns.productlisting.json",
                        "/templates/paginationControls.template":"http://localhost:9080/file/widget/productListing/templates/paginationControls.template",
                        "/locales/pl/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/pl/ns.productlisting.json",
                        "/locales/hu/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/hu/ns.productlisting.json",
                        "/locales/es/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/es/ns.productlisting.json",
                        "/locales/sv/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/sv/ns.productlisting.json",
                        "/config/locales/en.json":"http://localhost:9080/file/widget/productListing/config/locales/en.json",
                        "/locales/zh-CN/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/zh-CN/ns.productlisting.json",
                        "/locales/da/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/da/ns.productlisting.json",
                        "/locales/tr/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/tr/ns.productlisting.json",
                        "/locales/de/ns.productlisting.json":"http://localhost:9080/file/widget/productListing/locales/de/ns.productlisting.json",
                        "/js/product-listing.js":"http://localhost:9080/file/widget/productListing/js/product-listing.js"
                    },
                    "javascript":"product-listing",
                    "templateUrl":"http://localhost:9080/file/widget/productListing/templates/display.template",
                    "templateSrc":"",
                    "pageIds":[
                        "categoryPage"
                    ],
                    "elementsJs":{
                    },
                    "typeId":"productListing",
                    "editableWidget":true,
                    "gridWidth":"4"
                }
            ],
            "type":101,
            "height":300
        }
    ],
    "keywords":"Apparel",
    "isPreview":true,
    "canonicalRoute":"/apparel/category/cat90016",
    "metaTags":[
    ],
    "description":"Apparel",
    "title":"Apparel"
}

Default Response

The error response

Root Schema : errorModel

Type: object

Show Source

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

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "type":{
            "description":"The URI to the HTTP state code definition",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "errors":{
            "description":"An optional list of errors if multiple errors were encountered",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "errorCode":{
                        "description":"The numerical code identifying the error",
                        "type":"string"
                    },
                    "message":{
                        "description":"The localized message describing the error",
                        "type":"string"
                    },
                    "devMessage":{
                        "description":"An optional non-localized message containing technical information for developers",
                        "type":"string"
                    },
                    "moreInfo":{
                        "description":"An optional non-localized message with more information",
                        "type":"string"
                    },
                    "o:errorPath":{
                        "description":"An optional machine readable description of where the error occurred",
                        "type":"string"
                    },
                    "status":{
                        "description":"The HTTP status code",
                        "type":"string"
                    }
                }
            }
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}

Nested Schema : errors

Type: array

An optional list of errors if multiple errors were encountered

Show Source

Array of: object items

{
    "description":"An optional list of errors if multiple errors were encountered",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "errorCode":{
                "description":"The numerical code identifying the error",
                "type":"string"
            },
            "message":{
                "description":"The localized message describing the error",
                "type":"string"
            },
            "devMessage":{
                "description":"An optional non-localized message containing technical information for developers",
                "type":"string"
            },
            "moreInfo":{
                "description":"An optional non-localized message with more information",
                "type":"string"
            },
            "o:errorPath":{
                "description":"An optional machine readable description of where the error occurred",
                "type":"string"
            },
            "status":{
                "description":"The HTTP status code",
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

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

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}