Get category by id

GET /shops/@shop/categories/@id

Request

Optional authentication

You can use authentication for this request, but it is not required. Always provide the access_token when you have one. It may affect the response.

Header Value
Authorization Optional. Set the value to Bearer + + access_token

URL parameters

Replace the @ keywords in the URL with their corresponding value.

A dictionary with fields

Field Type Description
shop Int An integer value
id Int An integer value

Example request 1

GET /shops/14/categories/18 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 0.2.1
Accept-Language: en-US,en;q=0.5

Response

Field Type Description
id Int Id of the category
name String Translated category name
banner Image? Nullable.
messages [String] Array of String
products [Product.detailed] Array of Product.detailed
seo company.SeoData Optional. Product page SEO metatags

Example response 1

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 21243

{
    "id": 13,
    "name": "Mr. Jon Hand",
    "banner": {
        "resolutions": [
            {
                "src": "https://example.com",
                "width": 600,
                "height": 350
            },
            {
                "src": "https://example.com",
                "width": 600,
                "height": 350
            },
            {
                "src": "https://example.com",
                "width": 600,
                "height": 350
            }
        ],
        "white_background": true
    },
    "messages": [
        "...",
        "...",
        "..."
    ],
    "products": [
        {
            "id": 17,
            "name": "...",
            "images": [
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": false
                },
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": true
                },
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": true
                }
            ],
            "price_type": "PER_UNIT",
            "target_price": false,
            "price": 15,
            "subtitle": "...",
            "description": "...",
            "allergens": [
                {
                    "id": 16,
                    "name": "Lupine"
                },
                {
                    "id": 14,
                    "name": "Peanut"
                },
                {
                    "id": 16,
                    "name": "Mustard"
                }
            ],
            "url": "https://example.com",
            "url_type": "none",
            "specialty": true,
            "favourite": true,
            "product_prices": [
                {
                    "id": 14,
                    "name": "...",
                    "price": 15
                },
                {
                    "id": 14,
                    "name": "...",
                    "price": 10
                },
                {
                    "id": 19,
                    "name": "...",
                    "price": 13
                }
            ],
            "optionsets": [
                {
                    "id": 14,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 10,
                            "name": "...",
                            "price_change": 14
                        },
                        {
                            "id": 13,
                            "name": "...",
                            "price_change": 18
                        },
                        {
                            "id": 11,
                            "name": "...",
                            "price_change": 17
                        }
                    ]
                },
                {
                    "id": 18,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 17,
                            "name": "...",
                            "price_change": 14
                        },
                        {
                            "id": 16,
                            "name": "...",
                            "price_change": 15
                        },
                        {
                            "id": 10,
                            "name": "...",
                            "price_change": 19
                        }
                    ]
                },
                {
                    "id": 15,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 11,
                            "name": "...",
                            "price_change": 12
                        },
                        {
                            "id": 19,
                            "name": "...",
                            "price_change": 13
                        },
                        {
                            "id": 13,
                            "name": "...",
                            "price_change": 12
                        }
                    ]
                }
            ],
            "min_max": {
                "amount": {
                    "minimum": 15,
                    "maximum": 11,
                    "suggested": 17
                },
                "weight": {
                    "minimum": 10,
                    "maximum": 18,
                    "suggested": 11
                },
                "persons": {
                    "minimum": 10,
                    "maximum": 16,
                    "suggested": 13
                }
            },
            "info": [
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                },
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                },
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                }
            ]
        },
        {
            "id": 17,
            "name": "...",
            "images": [
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": false
                },
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": true
                },
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": false
                }
            ],
            "price_type": "PER_UNIT",
            "target_price": false,
            "price": 19,
            "subtitle": "...",
            "description": "...",
            "allergens": [
                {
                    "id": 10,
                    "name": "Lupine"
                },
                {
                    "id": 15,
                    "name": "Crustaceans"
                },
                {
                    "id": 16,
                    "name": "Lupine"
                }
            ],
            "url": "https://example.com",
            "url_type": "none",
            "specialty": false,
            "favourite": true,
            "product_prices": [
                {
                    "id": 12,
                    "name": "...",
                    "price": 11
                },
                {
                    "id": 11,
                    "name": "...",
                    "price": 10
                },
                {
                    "id": 14,
                    "name": "...",
                    "price": 14
                }
            ],
            "optionsets": [
                {
                    "id": 13,
                    "name": "...",
                    "allow_attachment": true,
                    "options": [
                        {
                            "id": 16,
                            "name": "...",
                            "price_change": 13
                        },
                        {
                            "id": 13,
                            "name": "...",
                            "price_change": 12
                        },
                        {
                            "id": 17,
                            "name": "...",
                            "price_change": 16
                        }
                    ]
                },
                {
                    "id": 12,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 17,
                            "name": "...",
                            "price_change": 10
                        },
                        {
                            "id": 15,
                            "name": "...",
                            "price_change": 15
                        },
                        {
                            "id": 12,
                            "name": "...",
                            "price_change": 17
                        }
                    ]
                },
                {
                    "id": 19,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 18,
                            "name": "...",
                            "price_change": 10
                        },
                        {
                            "id": 10,
                            "name": "...",
                            "price_change": 15
                        },
                        {
                            "id": 19,
                            "name": "...",
                            "price_change": 16
                        }
                    ]
                }
            ],
            "min_max": {
                "amount": {
                    "minimum": 13,
                    "maximum": 17,
                    "suggested": 11
                },
                "weight": {
                    "minimum": 18,
                    "maximum": 11,
                    "suggested": 19
                },
                "persons": {
                    "minimum": 18,
                    "maximum": 16,
                    "suggested": 16
                }
            },
            "info": [
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                },
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                },
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                }
            ]
        },
        {
            "id": 16,
            "name": "...",
            "images": [
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": false
                },
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": true
                },
                {
                    "resolutions": [
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        },
                        {
                            "src": "https://example.com",
                            "width": 600,
                            "height": 350
                        }
                    ],
                    "white_background": true
                }
            ],
            "price_type": "PER_UNIT",
            "target_price": true,
            "price": 12,
            "subtitle": "...",
            "description": "...",
            "allergens": [
                {
                    "id": 17,
                    "name": "Soy"
                },
                {
                    "id": 15,
                    "name": "Peanut"
                },
                {
                    "id": 10,
                    "name": "Mollusc"
                }
            ],
            "url": "https://example.com",
            "url_type": "none",
            "specialty": false,
            "favourite": true,
            "product_prices": [
                {
                    "id": 12,
                    "name": "...",
                    "price": 10
                },
                {
                    "id": 15,
                    "name": "...",
                    "price": 19
                },
                {
                    "id": 13,
                    "name": "...",
                    "price": 15
                }
            ],
            "optionsets": [
                {
                    "id": 19,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 13,
                            "name": "...",
                            "price_change": 17
                        },
                        {
                            "id": 13,
                            "name": "...",
                            "price_change": 16
                        },
                        {
                            "id": 17,
                            "name": "...",
                            "price_change": 11
                        }
                    ]
                },
                {
                    "id": 15,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 16,
                            "name": "...",
                            "price_change": 12
                        },
                        {
                            "id": 13,
                            "name": "...",
                            "price_change": 17
                        },
                        {
                            "id": 14,
                            "name": "...",
                            "price_change": 18
                        }
                    ]
                },
                {
                    "id": 17,
                    "name": "...",
                    "allow_attachment": false,
                    "options": [
                        {
                            "id": 17,
                            "name": "...",
                            "price_change": 13
                        },
                        {
                            "id": 13,
                            "name": "...",
                            "price_change": 15
                        },
                        {
                            "id": 12,
                            "name": "...",
                            "price_change": 11
                        }
                    ]
                }
            ],
            "min_max": {
                "amount": {
                    "minimum": 13,
                    "maximum": 10,
                    "suggested": 11
                },
                "weight": {
                    "minimum": 16,
                    "maximum": 14,
                    "suggested": 17
                },
                "persons": {
                    "minimum": 16,
                    "maximum": 16,
                    "suggested": 12
                }
            },
            "info": [
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                },
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                },
                {
                    "name": "...",
                    "title": "...",
                    "text": "...",
                    "type": "HTML"
                }
            ]
        }
    ],
    "seo": {
        "title": {
            "en": "Vero voluptatem sit consectetur iusto officia impedit sed quo."
        },
        "description": {
            "en": "Quae sint unde eius assumenda dolores vero. Rerum fugit ut rem quod perspiciatis sit quis."
        },
        "url": {
            "en": "https://hand.com/dolor-numquam-expedita-expedita-asperiores-dolores.html"
        }
    }
}
Version update available Please adjust your integration to the latest stable version (1.9.0)
0.2.1 stable