This class provides RESTful services to get category data for search-based catalog navigation. It performs the services by delegating to the CatalogNavigationView BOD service.
com.ibm.commerce.rest.search.handler.v2_0.CategoryViewHandler
HTTP Method | Path | Description |
---|---|---|
GET | /store/{storeId}/categoryview/{categoryIdentifier} | Gets category details based on its identifier (not the id assigned by the database). |
GET | /store/{storeId}/categoryview/@top | Gets all top level categories. |
GET | /store/{storeId}/categoryview/byId/{categoryId} | Gets category details based on its unique ID assigned by the database. |
GET | /store/{storeId}/categoryview/byIds | Gets category details based on its unique ID. |
GET | /store/{storeId}/categoryview/byParentCategory/{parentCategoryId} | Gets child categories based on the parent category unique ID. |
Gets category details based on its identifier (not the id assigned by the database).
findCategoryByIdentifier
false
true
Name | Description | Parameter Type | Data Type | Required | Allow Multiple |
---|---|---|---|---|---|
storeId | The store identifier. | path | string | true | N/A |
categoryIdentifier | The category identifier that was configured, not the one assigned by the database. | path | string | true | N/A |
catalogId | The catalog identifier. If none is specified, the store default catalog shall be used. | query | string | false | false |
checkEntitlement | Option to force an entitlement check. | query | boolean | false | false |
HTTP Status Code | Description |
---|---|
200 | The requested completed successfully. |
400 | Bad request. Some of the inputs provided to the request aren't valid. |
401 | Not authenticated. The user session isn't valid. |
403 | The user isn't authorized to perform the specified request. |
404 | The specified resource couldn't be found. |
500 | Internal server error. Additional details will be contained on the server logs. |
CategoryViewHandler/categoryresult.json
/search/resources/store/10001/categoryview/Dresses
200
{ "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_dresses.png", "identifier": "Dresses", "name": "Dresses", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10006", "shortDescription": "Dresses", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_dresses.png", "uniqueID": "10006" } ], "recordSetComplete": "true", "recordSetCount": 1, "recordSetStartNumber": 0, "recordSetTotal": 1, "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/Dresses", "resourceName": "categoryview" }
Gets all top level categories.
findTopCategories
false
true
Name | Description | Parameter Type | Data Type | Required | Allow Multiple |
---|---|---|---|---|---|
storeId | The store identifier. | path | string | true | N/A |
depthAndLimit | The comma separated list of numbers is to control the depth of sub-categories and limit the number of items returned under each child category level. The first number in this list determines the maximum of categories (first level sub-categories) to be returned under the immediate child category. The second number in the list determines the maximum number of categories to be returned under the first level sub-categories. A value of "-1" implies no limit. In that case, only the first level categories will be returned. For example, "pageSize=4&depthAndLimit=-1,3,0,1" implies that there will be unlimited first level sub-categories under the immediate child categories. Under these categories (up to 4), all sub-categories will be returned and a maximum of 3 second level sub-categories will be returned. There will be no third level or fourth level since the third level limit is 0. Any level after a limit of 0 will be ignored. By default, no sub-category will be returned if this parameter is not specified. When the asterisk "*" is specified, it is considered the same as "-1" but, any subsequent levels will also be treated "-1". | query | string | false | false |
orderBy | The field name to use when ordering the results. | query | string | false | false |
catalogId | The catalog identifier. If none is specified, the store default catalog shall be used. | query | string | false | false |
pageSize | Page size. Used to limit the amount of data returned by a query. Valid values include positive integers of 1 and above. The "pageNumber" must be specified for paging to work. | query | string | false | false |
pageNumber | Page number, starting at 1. Valid values include positive integers of 1 and above. The "pageSize" must be specified for paging to work. | query | string | false | false |
checkEntitlement | Option to force an entitlement check. | query | boolean | false | false |
HTTP Status Code | Description |
---|---|
200 | The requested completed successfully. |
400 | Bad request. Some of the inputs provided to the request aren't valid. |
401 | Not authenticated. The user session isn't valid. |
403 | The user isn't authorized to perform the specified request. |
404 | The specified resource couldn't be found. |
500 | Internal server error. Additional details will be contained on the server logs. |
CategoryViewHandler/topcategories.json
/search/resources/store/10001/categoryview/@top?catalogId=10052&depthAndLimit=11%2C11&responseFormat=json&langId=-1&contractId=10001
200
{ "catalogGroupView": [ { "catalogGroupView": [ { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gsh_shoes.png", "identifier": "Girls Shoes", "name": "Shoes", "parentCatalogGroupID": [ "10001_10005", "10052_10005" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10020", "shortDescription": "Shoes", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gsh_shoes.png", "uniqueID": "10020" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_pants.png", "identifier": "Girls Pants", "name": "Pants", "parentCatalogGroupID": [ "10001_10005", "10052_10005" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10021", "shortDescription": "Pants", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_pants.png", "uniqueID": "10021" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_skirts.png", "identifier": "Girls Dresses Skirts", "name": "Skirts", "parentCatalogGroupID": [ "10001_10005", "10052_10005" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10022", "shortDescription": "Skirts", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_skirts.png", "uniqueID": "10022" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_tops.png", "identifier": "Girls Tops", "name": "Tops", "parentCatalogGroupID": [ "10001_10005", "10052_10005" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10023", "shortDescription": "Tops", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_tops.png", "uniqueID": "10023" } ], "childCatalogGroupID": [ "10001_10020", "10001_10021", "10001_10022", "10001_10023", "10052_10020", "10052_10021", "10052_10022", "10052_10023" ], "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_app_girls.png", "identifier": "Girls", "name": "Girls", "parentCatalogGroupID": [ "10001_10001", "10052_10001" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10005", "shortDescription": "Girls", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_app_girls.png", "uniqueID": "10005" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bcl_pants.png", "identifier": "Boys Pants", "name": "Pants", "parentCatalogGroupID": [ "10001_10004", "10052_10004" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10024", "shortDescription": "Pants", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bcl_pants.png", "uniqueID": "10024" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bcl_tops.png", "identifier": "Boys Tops", "name": "Tops", "parentCatalogGroupID": [ "10001_10004", "10052_10004" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10025", "shortDescription": "Tops", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bcl_tops.png", "uniqueID": "10025" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bsh_shoes.png", "identifier": "Boys Shoes", "name": "Shoes", "parentCatalogGroupID": [ "10001_10004", "10052_10004" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10026", "shortDescription": "Shoes", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bsh_shoes.png", "uniqueID": "10026" } ], "childCatalogGroupID": [ "10001_10024", "10001_10025", "10001_10026", "10052_10024", "10052_10025", "10052_10026" ], "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_app_boys.png", "identifier": "Boys", "name": "Boys", "parentCatalogGroupID": [ "10001_10001", "10052_10001" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10004", "shortDescription": "boys", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_app_boys.png", "uniqueID": "10004" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_dresses.png", "identifier": "Dresses", "name": "Dresses", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10006", "shortDescription": "Dresses", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_dresses.png", "uniqueID": "10006" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_blouses.png", "identifier": "Women Shirts Blouses", "name": "Blouses", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10007", "shortDescription": "Blouses", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_blouses.png", "uniqueID": "10007" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_sweaters.png", "identifier": "Women Sweaters", "name": "Sweaters", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10008", "shortDescription": "Sweaters", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_sweaters.png", "uniqueID": "10008" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_skirts.png", "identifier": "Women Skirts", "name": "Skirts", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10009", "shortDescription": "Skirts", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_skirts.png", "uniqueID": "10009" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_pants.png", "identifier": "Women Pants", "name": "Pants", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10010", "shortDescription": "Pants", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_pants.png", "uniqueID": "10010" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wsh_shoes.png", "identifier": "Women Shoes", "name": "Shoes", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10011", "shortDescription": "Shoes", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wsh_shoes.png", "uniqueID": "10011" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wbg_handbags.png", "identifier": "Women Handbags", "name": "Handbags", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10012", "shortDescription": "Handbags", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wbg_handbags.png", "uniqueID": "10012" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wac_accessories.png", "identifier": "Women Accessories", "name": "Accessories", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10013", "shortDescription": "Accessories", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wac_accessories.png", "uniqueID": "10013" } ], "childCatalogGroupID": [ "10001_10006", "10001_10007", "10001_10008", "10001_10009", "10001_10010", "10001_10011", "10001_10012", "10001_10013", "10052_10006", "10052_10007", "10052_10008", "10052_10009", "10052_10010", "10052_10011", "10052_10012", "10052_10013" ], "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_app_women.png", "identifier": "Women", "name": "Women", "parentCatalogGroupID": [ "10001_10001", "10052_10001" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10003", "shortDescription": "Women", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_app_women.png", "uniqueID": "10003" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_jackets.png", "identifier": "Men Jackets", "name": "Jackets", "parentCatalogGroupID": [ "10001_10002", "10052_10002" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10014", "shortDescription": "Jackets", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_jackets.png", "uniqueID": "10014" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_shirts.png", "identifier": "Men Shirts", "name": "Shirts", "parentCatalogGroupID": [ "10001_10002", "10052_10002" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10015", "shortDescription": "Shirts", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_shirts.png", "uniqueID": "10015" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_suits.png", "identifier": "Men Suits", "name": "Suits", "parentCatalogGroupID": [ "10001_10002", "10052_10002" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10016", "shortDescription": "Suits", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_suits.png", "uniqueID": "10016" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_pants.png", "identifier": "Men Pants", "name": "Pants", "parentCatalogGroupID": [ "10001_10002", "10052_10002" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10017", "shortDescription": "Pants", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_pants.png", "uniqueID": "10017" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mac_accessories.png", "identifier": "Men Accessories", "name": "Accessories", "parentCatalogGroupID": [ "10001_10002", "10052_10002" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10018", "shortDescription": "Accessories", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mac_accessories.png", "uniqueID": "10018" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_msh_shoes.png", "identifier": "Men Shoes", "name": "Shoes", "parentCatalogGroupID": [ "10001_10002", "10052_10002" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10019", "shortDescription": "Shoes", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_msh_shoes.png", "uniqueID": "10019" } ], "childCatalogGroupID": [ "10001_10014", "10001_10015", "10001_10016", "10001_10017", "10001_10018", "10001_10019", "10052_10014", "10052_10015", "10052_10016", "10052_10017", "10052_10018", "10052_10019" ], "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_app_men.png", "identifier": "Men", "name": "Men", "parentCatalogGroupID": [ "10001_10001", "10052_10001" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10002", "shortDescription": "Men", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_app_men.png", "uniqueID": "10002" } ], "childCatalogGroupID": [ "10001_10005", "10001_10004", "10001_10003", "10001_10002", "10052_10005", "10052_10004", "10052_10003", "10052_10002" ], "identifier": "Apparel", "name": "Apparel", "parentCatalogGroupID": [ "10001_-1", "10052_-1" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10001", "shortDescription": "The latest styles for the entire family.", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_pants.png", "uniqueID": "10001" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cac_accessories.png", "identifier": "Computers Accessories", "name": "Accessories", "parentCatalogGroupID": [ "10001_10027", "10052_10027" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10028", "shortDescription": "Accessories", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cac_accessories.png", "uniqueID": "10028" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cta_tablets.png", "identifier": "Computers Tablets", "name": "Tablets", "parentCatalogGroupID": [ "10001_10027", "10052_10027" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10029", "shortDescription": "Tablets", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cta_tablets.png", "uniqueID": "10029" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cla_laptops.png", "identifier": "Computers Laptops", "name": "Laptops", "parentCatalogGroupID": [ "10001_10027", "10052_10027" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10030", "shortDescription": "Laptops", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cla_laptops.png", "uniqueID": "10030" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cde_desktops.png", "identifier": "Computers Desktops", "name": "Desktops", "parentCatalogGroupID": [ "10001_10027", "10052_10027" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10031", "shortDescription": "Desktops", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cde_desktops.png", "uniqueID": "10031" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_ccm_components.png", "identifier": "Computers Components", "name": "Components", "parentCatalogGroupID": [ "10001_10027", "10052_10027" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10032", "shortDescription": "Components", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_ccm_components.png", "uniqueID": "10032" } ], "childCatalogGroupID": [ "10001_10028", "10001_10029", "10001_10030", "10001_10031", "10001_10032", "10052_10028", "10052_10029", "10052_10030", "10052_10031", "10052_10032" ], "identifier": "Electronics", "name": "Electronics", "parentCatalogGroupID": [ "10001_-1", "10052_-1" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10027", "shortDescription": "Electronics", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/electronics\/category\/catr_cta_tablets.png", "uniqueID": "10027" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gda_dairy.png", "identifier": "Dairy", "name": "Dairy", "parentCatalogGroupID": [ "10001_10033", "10052_10033" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10034", "shortDescription": "Dairy", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gda_dairy.png", "uniqueID": "10034" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gfr_fruit.png", "identifier": "Fruit", "name": "Fruit", "parentCatalogGroupID": [ "10001_10033", "10052_10033" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10035", "shortDescription": "Fruit", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gfr_fruit.png", "uniqueID": "10035" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gme_meat.png", "identifier": "Meat", "name": "Meat", "parentCatalogGroupID": [ "10001_10033", "10052_10033" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10036", "shortDescription": "Meat", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gme_meat.png", "uniqueID": "10036" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gve_vegetables.png", "identifier": "Vegetables", "name": "Vegetables", "parentCatalogGroupID": [ "10001_10033", "10052_10033" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10037", "shortDescription": "Vegetables", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gve_vegetables.png", "uniqueID": "10037" } ], "childCatalogGroupID": [ "10001_10034", "10001_10035", "10001_10036", "10001_10037", "10052_10034", "10052_10035", "10052_10036", "10052_10037" ], "identifier": "Grocery", "name": "Grocery", "parentCatalogGroupID": [ "10001_-1", "10052_-1" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10033", "shortDescription": "Grocery", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/grocery\/category\/catr_gda_dairy.png", "uniqueID": "10033" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/health\/category\/catr_hme_medicine.png", "identifier": "Medicine", "name": "Medicine", "parentCatalogGroupID": [ "10001_10038", "10052_10038" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10039", "shortDescription": "Medicine", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/health\/category\/catr_hme_medicine.png", "uniqueID": "10039" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/health\/category\/catr_hvt_vitamins.png", "identifier": "Vitamins", "name": "Vitamins", "parentCatalogGroupID": [ "10001_10038", "10052_10038" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10040", "shortDescription": "Vitamins", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/health\/category\/catr_hvt_vitamins.png", "uniqueID": "10040" } ], "childCatalogGroupID": [ "10001_10039", "10001_10040", "10052_10039", "10052_10040" ], "identifier": "Health", "name": "Health", "parentCatalogGroupID": [ "10001_-1", "10052_-1" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10038", "shortDescription": "Health", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/health\/category\/catr_hme_medicine.png", "uniqueID": "10038" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hba_bath.png", "identifier": "Bath Accessories", "name": "Bath Accessories", "parentCatalogGroupID": [ "10001_10041", "10052_10041" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10042", "shortDescription": "Bath Accessories", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hba_bath.png", "uniqueID": "10042" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hfu_furniture.png", "identifier": "Furniture", "name": "Furniture", "parentCatalogGroupID": [ "10001_10041", "10052_10041" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10043", "shortDescription": "Furniture", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hfu_furniture.png", "uniqueID": "10043" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hkt_kitchenware.png", "identifier": "Kitchenware", "name": "Kitchenware", "parentCatalogGroupID": [ "10001_10041", "10052_10041" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10044", "shortDescription": "Kitchenware", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hkt_kitchenware.png", "uniqueID": "10044" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hlg_lighting.png", "identifier": "Lighting", "name": "Lighting", "parentCatalogGroupID": [ "10001_10041", "10052_10041" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10045", "shortDescription": "Lighting", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hlg_lighting.png", "uniqueID": "10045" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hta_tableware.png", "identifier": "Tableware", "name": "Tableware", "parentCatalogGroupID": [ "10001_10041", "10052_10041" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10046", "shortDescription": "Tableware", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hta_tableware.png", "uniqueID": "10046" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hap_appliances.png", "identifier": "Appliances", "name": "Appliances", "parentCatalogGroupID": [ "10001_10041", "10052_10041" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10047", "shortDescription": "Appliances", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hap_appliances.png", "uniqueID": "10047" } ], "childCatalogGroupID": [ "10001_10042", "10001_10043", "10001_10044", "10001_10045", "10001_10046", "10001_10047", "10052_10042", "10052_10043", "10052_10044", "10052_10045", "10052_10046", "10052_10047" ], "identifier": "Home Furnishings", "name": "Home & Furnishing", "parentCatalogGroupID": [ "10001_-1", "10052_-1" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10041", "shortDescription": "Home & Furnishing", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hap_appliances.png", "uniqueID": "10041" }, { "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/newslettersmagazines\/category\/catr_nma_magazines.png", "identifier": "Magazines", "name": "Magazines", "parentCatalogGroupID": [ "10001_10048", "10052_10048" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10049", "shortDescription": "Magazines", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/newslettersmagazines\/category\/catr_nma_magazines.png", "uniqueID": "10049" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/newslettersmagazines\/category\/catr_nne_newsletters.png", "identifier": "Newsletters", "name": "Newsletters", "parentCatalogGroupID": [ "10001_10048", "10052_10048" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10050", "shortDescription": "Newsletters", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/newslettersmagazines\/category\/catr_nne_newsletters.png", "uniqueID": "10050" } ], "childCatalogGroupID": [ "10001_10049", "10001_10050", "10052_10049", "10052_10050" ], "identifier": "NewslettersAndMagazines", "name": "Newsletters & Magazines", "parentCatalogGroupID": [ "10001_-1", "10052_-1" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10048", "shortDescription": "Newsletters & Magazines", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/newslettersmagazines\/category\/catr_nma_magazines.png", "uniqueID": "10048" } ], "recordSetComplete": "true", "recordSetCount": 50, "recordSetStartNumber": 0, "recordSetTotal": 50, "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/@top?catalogId=10052&depthAndLimit=11%2C11&responseFormat=json&langId=-1&contractId=10001", "resourceName": "categoryview" }
Gets category details based on its unique ID assigned by the database.
findCategoryByUniqueId
false
true
Name | Description | Parameter Type | Data Type | Required | Allow Multiple |
---|---|---|---|---|---|
storeId | The store identifier. | path | string | true | N/A |
categoryId | The category identifier that was assigned by the database. | path | string | true | N/A |
catalogId | The catalog identifier. If none is specified, the store default catalog shall be used. | query | string | false | false |
checkEntitlement | Option to force an entitlement check. | query | boolean | false | false |
HTTP Status Code | Description |
---|---|
200 | The requested completed successfully. |
400 | Bad request. Some of the inputs provided to the request aren't valid. |
401 | Not authenticated. The user session isn't valid. |
403 | The user isn't authorized to perform the specified request. |
404 | The specified resource couldn't be found. |
500 | Internal server error. Additional details will be contained on the server logs. |
CategoryViewHandler/categoryresult.json
/search/resources/store/10001/categoryview/byId/10043?currency=USD&catalogId=10052&responseFormat=json&langId=-1&contractId=10001
200
{ "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hfu_furniture.png", "identifier": "Furniture", "name": "Furniture", "parentCatalogGroupID": [ "10001_10041", "10052_10041" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10043", "shortDescription": "Furniture", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/homefurnishings\/category\/catr_hfu_furniture.png", "uniqueID": "10043" } ], "recordSetComplete": "true", "recordSetCount": 1, "recordSetStartNumber": 0, "recordSetTotal": 1, "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10043?currency=USD&catalogId=10052&responseFormat=json&langId=-1&contractId=10001", "resourceName": "categoryview" }
Gets category details based on its unique ID.
findCategoryByUniqueIds
false
true
Name | Description | Parameter Type | Data Type | Required | Allow Multiple |
---|---|---|---|---|---|
storeId | The store identifier. | path | string | true | N/A |
id | The list of category identifier. | query | string | false | true |
catalogId | The catalog identifier. If none is specified, the store default catalog shall be used. | query | string | false | false |
orderBy | The field name to use when ordering the results. | query | string | false | false |
checkEntitlement | Option to force an entitlement check. | query | boolean | false | false |
HTTP Status Code | Description |
---|---|
200 | The requested completed successfully. |
400 | Bad request. Some of the inputs provided to the request aren't valid. |
401 | Not authenticated. The user session isn't valid. |
403 | The user isn't authorized to perform the specified request. |
404 | The specified resource couldn't be found. |
500 | Internal server error. Additional details will be contained on the server logs. |
CategoryViewHandler/categoriesresult.json
/search/resources/store/10001/categoryview/byIds?currency=USD&catalogId=10052&responseFormat=json&langId=-1&id=10007&id=10013&id=10016&id=10022&id=10025&contractId=10001
200
{ "catalogGroupView": [ { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_blouses.png", "identifier": "Women Shirts Blouses", "name": "Blouses", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10007", "shortDescription": "Blouses", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wcl_blouses.png", "uniqueID": "10007" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wac_accessories.png", "identifier": "Women Accessories", "name": "Accessories", "parentCatalogGroupID": [ "10001_10003", "10052_10003" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10013", "shortDescription": "Accessories", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/women\/category\/catr_wac_accessories.png", "uniqueID": "10013" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_suits.png", "identifier": "Men Suits", "name": "Suits", "parentCatalogGroupID": [ "10001_10002", "10052_10002" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10016", "shortDescription": "Suits", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/men\/category\/catr_mcl_suits.png", "uniqueID": "10016" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_skirts.png", "identifier": "Girls Dresses Skirts", "name": "Skirts", "parentCatalogGroupID": [ "10001_10005", "10052_10005" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10022", "shortDescription": "Skirts", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/girls\/category\/catr_gcl_skirts.png", "uniqueID": "10022" }, { "fullImage": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bcl_tops.png", "identifier": "Boys Tops", "name": "Tops", "parentCatalogGroupID": [ "10001_10004", "10052_10004" ], "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byId\/10025", "shortDescription": "Tops", "storeID": "10001", "thumbnail": "\/wcsstore\/Aurora\/images\/catalog\/apparel\/boys\/category\/catr_bcl_tops.png", "uniqueID": "10025" } ], "recordSetComplete": "true", "recordSetCount": 5, "recordSetStartNumber": 0, "recordSetTotal": 5, "resourceId": "http:\/\/localhost\/search\/resources\/store\/10001\/categoryview\/byIds?currency=USD&catalogId=10052&responseFormat=json&langId=-1&id=10007&id=10013&id=10016&id=10022&id=10025&contractId=10001", "resourceName": "categoryview" }
Gets child categories based on the parent category unique ID.
findSubCategories
false
true
Name | Description | Parameter Type | Data Type | Required | Allow Multiple |
---|---|---|---|---|---|
storeId | The store identifier. | path | string | true | N/A |
parentCategoryId | The parent category id. | path | string | true | N/A |
depthAndLimit | The comma separated list of numbers is to control the depth of sub-categories and limit the number of items returned under each child category level. The first number in this list determines the maximum of categories (first level sub-categories) to be returned under the immediate child category. The second number in the list determines the maximum number of categories to be returned under the first level sub-categories. A value of "-1" implies no limit. In that case, only the first level categories will be returned. For example, "pageSize=4&limitSubCategories=-1,3,0,1" implies that there will be unlimited first level sub-categories under the immediate child categories. Under these categories (up to 4), all sub-categories will be returned and a maximum of 3 second level sub-categories will be returned. There will be no third level or fourth level since the third level limit is 0. Any level after a limit of 0 will be ignored. By default, no sub-category will be returned if this parameter is not specified. When the asterisk "*" is specified, it is considered the same as "-1" but, any subsequent levels will also be treated "-1". | query | string | false | false |
orderBy | The field name to use when ordering the results. | query | string | false | false |
catalogId | The catalog identifier. If none is specified, the store default catalog shall be used. | query | string | false | false |
pageSize | Page size. Used to limit the amount of data returned by a query. Valid values include positive integers of 1 and above. The "pageNumber" must be specified for paging to work. | query | string | false | false |
pageNumber | Page number, starting at 1. Valid values include positive integers of 1 and above. The "pageSize" must be specified for paging to work. | query | string | false | false |
checkEntitlement | Option to force an entitlement check. | query | boolean | false | false |
HTTP Status Code | Description |
---|---|
200 | The requested completed successfully. |
400 | Bad request. Some of the inputs provided to the request aren't valid. |
401 | Not authenticated. The user session isn't valid. |
403 | The user isn't authorized to perform the specified request. |
404 | The specified resource couldn't be found. |
500 | Internal server error. Additional details will be contained on the server logs. |
Name | Data Type | Required |
---|---|---|
recordSetTotal | string | false |
resourceId | string | false |
resourceName | string | false |
recordSetComplete | string | false |
recordSetStartNumber | string | false |
catalogGroupView | CategoryViewHandler/categoriesresult.json.catalogGroupView array | false |
recordSetCount | string | false |
metaData | string | false |
Name | Data Type | Required |
---|---|---|
shortDescription | string | false |
identifier | string | false |
resourceId | string | false |
name | string | false |
parentCatalogGroupID | string | false |
productsURL | string | false |
fullImage | string | false |
storeID | string | false |
thumbnail | string | false |
uniqueID | string | false |
childCatalogGroupID | string array | false |
Name | Data Type | Required |
---|---|---|
price | string | false |
Name | Data Type | Required |
---|---|---|
recordSetTotal | string | false |
resourceId | string | false |
resourceName | string | false |
recordSetComplete | string | false |
recordSetStartNumber | string | false |
catalogGroupView | CategoryViewHandler/categoryresult.json.catalogGroupView array | false |
recordSetCount | string | false |
metaData | string | false |
Name | Data Type | Required |
---|---|---|
shortDescription | string | false |
identifier | string | false |
resourceId | string | false |
name | string | false |
parentCatalogGroupID | string | false |
productsURL | string | false |
fullImage | string | false |
storeID | string | false |
thumbnail | string | false |
uniqueID | string | false |
childCatalogGroupID | string array | false |
Name | Data Type | Required |
---|---|---|
price | string | false |
Name | Data Type | Required |
---|---|---|
recordSetTotal | string | false |
resourceId | string | false |
resourceName | string | false |
recordSetComplete | string | false |
recordSetStartNumber | string | false |
catalogGroupView | CategoryViewHandler/topcategories.json.catalogGroupView array | false |
recordSetCount | string | false |
metaData | string | false |
Name | Data Type | Required |
---|---|---|
shortDescription | string | false |
identifier | string | false |
resourceId | string | false |
name | string | false |
parentCatalogGroupID | string | false |
productsURL | string | false |
storeID | string | false |
thumbnail | string | false |
uniqueID | string | false |
childCatalogGroupID | string array | false |
Name | Data Type | Required |
---|---|---|
price | string | false |