Get all the categories that belong to a shop

GET /company/shops/@id/categories

Request

Authentication

This endpoint requires authentication.

Header Value
Authorization 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
id Int Return all categories of the given shop

Example request 1

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

Response

Array of company.Category.simple: [company.Category.simple]

company.Category.simple

Field Type Description
name [Language: String] Translated category name
description [Language: String] Description of this category
active Bool A boolean value
only_order_in_store Bool Whether this product can only get ordered in the store with a separate UI for the shop employees, and not in the public webshop
code String? Nullable. A custom code. You can set this to your own code and use this field to map your categories to Bakeronline categories
id Int ID of the category
banner Image? Nullable.
overview_image Image? Nullable.
seo company.SeoData Optional. The category's webpage search engine metatags

Example response 1

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

[
    {
        "name": "Albin Hartmann",
        "description": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "active": false,
        "only_order_in_store": true,
        "code": "...",
        "id": 14,
        "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
                }
            ],
            "file_id": 12,
            "white_background": false
        },
        "overview_image": {
            "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
                }
            ],
            "file_id": 16,
            "white_background": false
        },
        "seo": {
            "title": {
                "en": "Et sint quis non nemo molestias."
            },
            "description": {
                "en": "Quam et et minima ut. Velit quaerat sint et. Eveniet ut tempora illum at. Quam voluptas consectetur nesciunt iure omnis."
            },
            "url": {
                "en": "https://www.gerlach.com/vero-aut-ipsum-maxime-voluptas"
            }
        }
    },
    {
        "name": "Dr. Zane Effertz PhD",
        "description": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "active": true,
        "only_order_in_store": false,
        "code": "...",
        "id": 10,
        "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
                }
            ],
            "file_id": 11,
            "white_background": false
        },
        "overview_image": {
            "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
                }
            ],
            "file_id": 14,
            "white_background": true
        },
        "seo": {
            "title": {
                "en": "Praesentium similique reiciendis tenetur eum et."
            },
            "description": {
                "en": "Perspiciatis et aut quae qui voluptatem sed. Voluptatem illum enim officiis maiores est in. Veritatis quia eos quos quia voluptate. Et repellendus corporis aut vitae itaque."
            },
            "url": {
                "en": "http://carroll.org/"
            }
        }
    },
    {
        "name": "Nella Stoltenberg II",
        "description": {
            "nl": "...",
            "en": "...",
            "fr": "..."
        },
        "active": true,
        "only_order_in_store": false,
        "code": "...",
        "id": 14,
        "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
                }
            ],
            "file_id": 10,
            "white_background": true
        },
        "overview_image": {
            "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
                }
            ],
            "file_id": 18,
            "white_background": false
        },
        "seo": {
            "title": {
                "en": "Nobis dolorum qui quisquam labore minima saepe corrupti eaque et et aliquid."
            },
            "description": {
                "en": "Reprehenderit nihil consequatur ut ut amet. Molestiae nesciunt tempora temporibus et saepe."
            },
            "url": {
                "en": "http://www.roob.com/"
            }
        }
    }
]
1.9.0 stable