Categories
HTTP Verb – GET
URL – /api/v1/categories
Description – Return a collection of hierarchical categories.
Base – HandlerBase<GetCategoryCollectionParameter, GetCategoryCollectionResult>
Handlers –
Order | Handler | Description |
|---|---|---|
500 | GetMaxDepth | Populates the max depth to search for categories. The MaxDepthproperty on the parameter object is used if it has a value, otherwise the Catalog "Category Menu Depth" setting is used. When the setting is used, the depth is limited to 3. The max depth is stored in the MaxDepthproperty on the result object. |
600 | GetStartCategory | Retrieves the category from where the category tree will begin. If the StartCategoryIdproperty on the parameter object has no value, this handler is skipped. The category is stored in the StartCategoryproperty on the result object. |
700 | GetBaseLink | Sets result BaseLink to blank if the start category is null, otherwise to the url of the start category. |
800 | GetCategories | If the StartCategory property on the parameter object is not null, the application retrieves the active base categories (root categories). Otherwise, the application retrieves the subcategories for the category stored in the StartCategoryproperty. The result is stored in the Categoriesproperty on the result object. |
900 | CreateCategoryNavLinks | Transforms the category tree into a collection of NavLinkDtoobjects that contain information like the URL path, name, and subcategories. The StartCategorycategory is not included in the category tree. |
HTTP Verb – GET
URL – /api/v1/categories/
Description – Return a single category
Base – HandlerBase<GetCategoryParameter, GetCategoryResult>
Handlers –
Order | Handler | Description |
|---|---|---|
500 | GetCategory | Retrieves a category using the CategoryId property on the parameter object. If a category is not found or the category is not assigned to the current website, an error is returned. The category is stored in the Category property on the result object. |
600 | CopyCustomPropertiesToResult | Copies custom properties configured for the category entity to the Properties property on the result object. |