Category

Get All Categories

Endpoint:

GET {{url}}/api/v1/rest/categories

Query Parameters

Name	Info	Type	Default
filters	Filter by parent category (e.g., master)	JSON	N/A
page	Page number to retrieve	Number	1

Usage Examples

• Filters: Retrieve categories that have a specific parent category.

  GET {{url}}/api/v1/rest/categories?filters={"parent":[{"operator":"=","value": "master"}]}

• Page: Retrieve a specific page of categories.

  GET {{url}}/api/v1/rest/categories?page=1

Headers

Key	Value
Accept	application/json
Authorization	Bearer access_token

Response

The API will return a list of categories in a JSON format.

Response

{
  "data": [
      {
          "code": "root",
          "parent": null,
          "additional_data": null
      }
  ],
  "current_page": 1,
  "last_page": 1,
  "total": 1,
  "links": {
    "first": "{{url}}/api/v1/rest/categories?page=1",
    "last": "{{url}}/api/v1/rest/categories?page=1",
    "next": null,
    "prev": null
  }
}

---

Get Category by Category Code

Endpoint:

GET {{url}}/api/v1/rest/categories/{category_code}

• category_code: The unique code for the category (e.g., master_accessories) to fetch details for a specific category.

Headers

Key	Value
Accept	application/json
Authorization	Bearer access_token

Response

The response will contain details of the requested category.

Response

{
    "code": "electronic",
    "parent": null,
    "additional_data": {
        "locale_specific": {
            "en_US": {
                "name": "Electronic (en_US)",
                "description": "<ol>\n<li><em><strong>Electronics category Description Editor</strong></em></li>\n</ol>"
            }
        }
    }
}

---

Create a Category

Endpoint:

POST {{url}}/api/v1/rest/categories

Headers

Key	Value
Accept	application/json
Authorization	Bearer access_token

Request Body

To create a new category, provide the category code, parent category, and any additional data.

Example Request Body:

{
    "code": "electronic",
    "parent": "root",
    "additional_data": {
        "locale_specific": {
            "en_US": {
                "name": "Electronic (en_US)",
                "description": "<ol>\r\n<li><em><strong>Electronics category Description Editor</strong></em></li>\r\n</ol>"
            }
        }
    }
}

Response

Upon successful creation, the API will return a success message.

Response

{
  "success": true,
  "message": "Category Created Successfully"
}

Update a Category

Endpoint:

PUT {{url}}/api/v1/rest/categories/{category_code}

Headers

Key	Value
Accept	application/json
Authorization	Bearer access_token

Path Parameter

• category_code: The unique code for the category to be updated.

Request Body

To update a category, provide the category code, parent category, and any additional data that needs to be updated. Any existing fields not included in the request will remain unchanged.

Example Request Body:

{
    "code": "electronic",
    "parent": "root",
    "additional_data": {
        "locale_specific": {
            "en_US": {
                "name": "Electronic",
                "description": "<ol>\r\n<li><em><strong>Electronics category Description Editor</strong></em></li>\r\n</ol>"
            }
        }
    }
}

Response

Upon successful update, the API will return a success message indicating the category has been updated.

Response

{
  "success": true,
  "message": "Category Updated Successfully"
}

Patch a Category

Endpoint:

PATCH {{url}}/api/v1/rest/categories/{category_code}

Headers

Key	Value
Accept	application/json
Authorization	Bearer access_token

Path Parameter

Name	Description	Type
category_code	The unique code of the category	String

Example:

PATCH {{url}}/api/v1/rest/categories/electronic

Payload

Only include the fields that need to be updated:

{
    "additional_data": {
        "locale_specific": {
            "en_US": {
                "name": "Updated Electronic Name",
                "description": "<ol>\r\n<li><em><strong>Updated Electronics category Description Editor</strong></em></li>\r\n</ol>"
            }
        }
    }
}

Response

Response

{
    "success": true,
    "message": "Category updated successfully."
}

---

Delete a Category

Endpoint:

DELETE {{url}}/api/v1/rest/categories/{category_code}

Headers

Key	Value
Accept	application/json
Authorization	Bearer access_token

Path Parameter

Name	Description	Type
category_code	The unique code of the category	String

Example:

DELETE {{url}}/api/v1/rest/categories/electronic

Response

Response

{
    "success": true,
    "message": "Category deleted successfully",
    "code": "electronic"
}