Categories

Get all categories

You can access the list of 5 categories by using the /categories endpoint.

[GET] http://api.escuelajs.co/api/v1/categories

[
  {
    "id": 1,
    "name": "Clothes",
    "image": "https://placeimg.com/640/480/any"
  }
  // ...
]

Get a single category

You can get a single category by adding the id as a parameter: /categories/{id}

[GET] http://api.escuelajs.co/api/v1/categories/1

{
  "id": 1,
  "name": "Clothes",
  "image": "https://placeimg.com/640/480/any"
}

Create a category

You can create a new category by sending an object like the following to /categories/

[POST] http://api.escuelajs.co/api/v1/categories/

{
  "name": "New Category",
  "image": "https://placeimg.com/640/480/any"
}

Note that the image is an URLs.

Update a category

You can update a category exists by sending an object like the following and adding the id as a parameter: /categories/{id}

[PUT] http://api.escuelajs.co/api/v1/categories/1

{
  "name": "Change name",
}

Note that it is not necessary to send all product attributes, just send the attributes that want to update.

Delete a category

You can delete a category exists by adding the id as a parameter: /categories/{id}

[DELETE] http://api.escuelajs.co/api/v1/categories/1

Get all products by category

You can get the products by category adding the categoryID as a parameter to /categories/{categoryID}/products

[GET] http://api.escuelajs.co/api/v1/categories/1/products

[
  {
    "id": 4,
    "title": "Handmade Fresh Table",
    "price": 687,
    "description": "Andy shoes are designed to keeping in...",
    "category": {
      "id": 1,
      "name": "Others",
      "image": "https://placeimg.com/640/480/any?r=0.591926261873231"
    },
    "images": [
      "https://placeimg.com/640/480/any?r=0.9178516507833767",
      "https://placeimg.com/640/480/any?r=0.9300320592588625",
      "https://placeimg.com/640/480/any?r=0.8807778235430017"
    ]
  },
  // ...
]

Schema Category