Skip to content

Categories

Get all categories

You can access the list of 5 categories by using the categories query.

Query:

query {
  categories {
    id
    name
    image
  }
}

Response:

{
  "data": {
    "categories": [
      {
        "id": "1",
        "name": "Clothes",
        "image": "https://api.lorem.space/image/fashion?w=640&h=480&r=7943"
      },
      ...
    ]
  }
}

Get a single category

You can get a single category by adding the id as a parameter to category query.

Query:

query {
  category(id: 1) {
    id
    name
    image
  }
}

Response:

{
  "data": {
    "category": {
      "id": "1",
      "name": "Clothes",
      "image": "https://api.lorem.space/image/fashion?w=640&h=480&r=7943"
    }
  }
}

Create a category

You can create a new category by sending an object like the following to the addCategory mutation.

Mutation:

mutation {
  addCategory(
    data: { name: "New Category", image: "https://placeimg.com/640/480/any" }
  ) {
    id
    name
    image
  }
}

Response:

{
  "data": {
    "addCategory": {
      "id": "6",
      "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 to the updateCategory mutation.

Mutation:

mutation {
  updateCategory(id: 1, changes: { name: "change" }) {
    id
    name
    image
  }
}

Response:

{
  "data": {
    "updateCategory": {
      "id": "1",
      "name": "change",
      "image": "https://api.lorem.space/image/fashion?w=640&h=480&r=7943"
    }
  }
}

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 to the deleteCategory mutation.

Mutation:

mutation {
  deleteCategory(id: 12)
}

Response:

{
  "data": {
    "deleteCategory": true
  }
}

Schema Category

AttributeTypeDescription
idnumberThe id of the category.
namestringName of the category.
imagestringThe string with URL to a image