COconstructor
Recommendation pages

Create recommendation page

🔐 This endpoint requires HTTP authentication (either Basic or Bearer). For authenticating with Bearer token, required scopes are: recommendations(w).

Beta: This endpoint is in beta and may change. It is currently available to a small group of users. To request access, contact your Customer Success Manager.

Create a page and return it. Answers 409 if a page is already configured under that page_id for this key and section; use PUT to replace one. Answers 404 if a pod in pods is not configured for this key and section, and 400 if pods repeats a pod or lists more pods than the page limit. pods may be empty.

post/v1/recommendation_pages

Request

  • Base URL
    https://ac.cnstrc.com
  • URL
    https://ac.cnstrc.com/v1/recommendation_pages
  • Auth
    • HTTP basic
    • or HTTP bearer

Query parameters

keystring required

The key of the index to use.

Example:key_K2pX7vBnU0bgA5xp
sectionstring

The section of the index to use. Defaults to Products.

Example:Products
cstring

The ID of the client and version that the request is coming from, such as cio-js-2.90.

Example:cio-js-2.90

Request body

page_idstring required

The unique identifier of the page within the key and section: a lowercase slug of letters, digits, underscores and hyphens, starting with a letter or digit, at most 255 characters. Surrounding whitespace is stripped.

display_namestring required

The name of the page displayed to merchandisers, between 2 and 100 characters. Surrounding whitespace is stripped.

page_type'pdp' | 'plp' | 'home' | 'cart' | 'atc' | 'checkout' | 'order_confirm' | 'empty_cart' | 'other' required

Example request

{
  "page_id": "pdp_b2c",
  "display_name": "PDP - B2C",
  "pods": [
    {
      "pod_id": "similar_items"
    }
  ]
}

Response

OK

page_idstring required

The unique identifier of the page within the key and section: a lowercase slug of letters, digits, underscores and hyphens, starting with a letter or digit, at most 255 characters. Surrounding whitespace is stripped.

display_namestring required

The name of the page displayed to merchandisers, between 2 and 100 characters. Surrounding whitespace is stripped.

page_type'pdp' | 'plp' | 'home' | 'cart' | 'atc' | 'checkout' | 'order_confirm' | 'empty_cart' | 'other' required
created_atstring date-time required

The date and time the page was created.

updated_atstring date-time required

The date and time the page was last updated.

Example response

{
  "page_id": "pdp_b2c",
  "display_name": "PDP - B2C",
  "pods": [
    {
      "pod_id": "similar_items"
    }
  ],
  "created_at": "2021-01-01T00:00:00",
  "updated_at": "2021-02-01T00:00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.