commerce/settings/general/customroutes
Use the Custom Routes resource to manage your custom route settings. Custom routing allows you to display SEO-friendly URLs on your site that map behind-the-scenes to conventional Kibo eCommerce resources such as a product page or a search results page. With custom routing, you gain advanced control over the URL structures on your site and can more visibly highlight the products or categories your shoppers are interested in purchasing.
To learn more about custom routing, refer to the Custom Route Settings topic.
JSON Example
CustomRouteSettings Properties
Property | Description |
---|---|
mappings |
type: System.String,Mozu.SiteSettings.General.Contracts.General.Routing.Mapping The mappings configured for the site. Mappings allow you to map the values of URL parameters to other JSON variables or to Kibo eCommerce objects such as facet values. |
routes |
type: list of route The routes configured for the site. Routes contain all the information necessary to match incoming URLs to a specific page in Kibo eCommerce. |
route |
type: bool When true, specifies that the route is a canonical route. |
route |
type: System.String,System.Object An array of key-value pairs that provide default values for required route parameters. |
route |
type: string For Arc.js routes, specifies the Arc.js function name to create a route to. For example: "internalRoute": "Arcjs",
|
route |
type: string Specifies the internal route to use for a particular URL template. For example, the "ProductDetails" internal route routes matching URLs to a product page. |
route |
type: System.String,System.String[] The list of mappings that a particular route uses. |
route |
type: string Specifies the pattern of URL constants, variables, and segments that result in a match for a particular route. |
route |
type: string Specifies whether a custom route uses an http or https protocol. This allows you to set encryption on a route generated from a non-secure request, or vice-versa. |
route |
type: System.String,System.String[] Specifies the validators that a particular route uses. |
validators |
type: System.String,Mozu.SiteSettings.General.Contracts.General.Routing.Validator The validators configured for a site. Validators require that URL parameters meet certain conditions before Kibo eCommerce considers the template a match. |
Operations
Operation Name | Request URI | Description |
---|---|---|
CreateCustomRouteSettings | POST customroutes%3fresponseFields%3d%7bresponseFields%7d |
Create new custom route settings. |
DeleteCustomRouteSettings | DELETE customroutes |
Deletes all the custom route settings for a site, returning all routes to their Kibo eCommerce defaults. |
GetCustomRouteSettings | GET customroutes%3fresponseFields%3d%7bresponseFields%7d |
Retrieves the custom route settings configured for a site. These are the same settings configured through Admin in the Custom Routing JSON Editor. |
UpdateCustomRouteSettings | PUT customroutes%3fresponseFields%3d%7bresponseFields%7d |
Updates custom route settings. |