Get shop by url

GET /shops/url/@url

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
url String A String value

Example request 1

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

Response

Field Type Description
id Int Id of the shop
name String Name of the shop (translated)
address Address.detailed An address
allow_comments Bool A boolean value
url String A String value
allow_order_comments Bool A boolean value
allow_product_comments Bool A boolean value
allow_order_messages Bool A boolean value
global_discount_percentage Int Discount percentage for all products
offers [Offer.detailed] Array of Offer.detailed
images [String: Image] Dictionary of Image with keys of type String
allow_orders Bool A boolean value
delivery_use_intervals Bool A boolean value
categories [Category.simple] Array of Category.simple
category_groups [CategoryGroup] List of category groups. The ids refer to a category in the categories field. Categories without a CategoryGroup should also get displayed.
allow_invoices Bool A boolean value
category_groups_overview Bool Show an overview of all the category groups on the webshop homepage
display_mode String String enumarion of 'blocks', 'list'
takeout_use_intervals Bool A boolean value
joyn_enabled Bool A boolean value
category_overview Bool Show an overview of all the categories on the webshop homepage
fold_category_groups Bool Whether the shop prefers to hide all the categories for all category groups by default
hours [MethodHours] Information about the opening hours, delivery hours... for all available methods and machines
contact Contact Contact details of a shop
messages [Message] You are required to keep track of the messages the user saw. When you receive new messages, you should indicate this in the app with a bubble icon (e.g. red circle with number of new messages)
info [Message] Same as messages, but you shouldn't notify the user when this changes or is received for the first time
status ShopStatus
has_specialties Bool A boolean value
promotion Promotion The info about the shop promotion
delivery Dictionary A dictionary with fields
currency Currency 3 letter ISO 4217 currency name (string)

Example response 1

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

{
    "id": 15,
    "name": "Prof. Pearl Jaskolski Jr.",
    "address": {
        "street": "Sint-Denijslaan",
        "nr": "96",
        "zipcode": "9000",
        "city": "Gent",
        "country": "BE",
        "position": {
            "latitude": 1.54361,
            "longitude": 0.45645
        }
    },
    "allow_comments": false,
    "url": "...",
    "allow_order_comments": true,
    "allow_product_comments": true,
    "allow_order_messages": false,
    "global_discount_percentage": 10,
    "offers": [
        {
            "id": 18,
            "name": "Black Friday",
            "from_date": "2019-01-31",
            "until_date": "2019-01-31",
            "valid_for": "order",
            "recurring": 11,
            "recurring_on": {
                "day_1": 17,
                "day_2": 14,
                "day_3": 14,
                "day_4": 12,
                "day_5": 17,
                "day_6": 10,
                "day_7": 13
            },
            "items": [
                {
                    "type": "percentage",
                    "x": 12,
                    "y": 19,
                    "percentage": 18,
                    "minimum": 18,
                    "applies_to": "category",
                    "item_id": 15
                },
                {
                    "type": "percentage",
                    "x": 11,
                    "y": 19,
                    "percentage": 17,
                    "minimum": 18,
                    "applies_to": "category",
                    "item_id": 17
                },
                {
                    "type": "percentage",
                    "x": 11,
                    "y": 10,
                    "percentage": 17,
                    "minimum": 16,
                    "applies_to": "category",
                    "item_id": 15
                }
            ]
        },
        {
            "id": 18,
            "name": "Black Friday",
            "from_date": "2019-01-31",
            "until_date": "2019-01-31",
            "valid_for": "order",
            "recurring": 11,
            "recurring_on": {
                "day_1": 10,
                "day_2": 12,
                "day_3": 18,
                "day_4": 10,
                "day_5": 18,
                "day_6": 18,
                "day_7": 17
            },
            "items": [
                {
                    "type": "percentage",
                    "x": 10,
                    "y": 10,
                    "percentage": 18,
                    "minimum": 14,
                    "applies_to": "category",
                    "item_id": 11
                },
                {
                    "type": "percentage",
                    "x": 18,
                    "y": 18,
                    "percentage": 14,
                    "minimum": 12,
                    "applies_to": "category",
                    "item_id": 17
                },
                {
                    "type": "percentage",
                    "x": 19,
                    "y": 19,
                    "percentage": 10,
                    "minimum": 10,
                    "applies_to": "category",
                    "item_id": 14
                }
            ]
        },
        {
            "id": 16,
            "name": "Black Friday",
            "from_date": "2019-01-31",
            "until_date": "2019-01-31",
            "valid_for": "order",
            "recurring": 19,
            "recurring_on": {
                "day_1": 19,
                "day_2": 15,
                "day_3": 10,
                "day_4": 18,
                "day_5": 19,
                "day_6": 17,
                "day_7": 14
            },
            "items": [
                {
                    "type": "percentage",
                    "x": 18,
                    "y": 18,
                    "percentage": 13,
                    "minimum": 10,
                    "applies_to": "category",
                    "item_id": 13
                },
                {
                    "type": "percentage",
                    "x": 15,
                    "y": 17,
                    "percentage": 13,
                    "minimum": 13,
                    "applies_to": "category",
                    "item_id": 15
                },
                {
                    "type": "percentage",
                    "x": 17,
                    "y": 11,
                    "percentage": 17,
                    "minimum": 11,
                    "applies_to": "category",
                    "item_id": 11
                }
            ]
        }
    ],
    "images": {
        "avatar": {
            "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": false
        }
    },
    "allow_orders": true,
    "delivery_use_intervals": true,
    "categories": [
        {
            "id": 12,
            "name": "Prof. Noemie Keeling",
            "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": true
            },
            "only_order_in_store": false,
            "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": 17,
                "white_background": true
            },
            "seo": {
                "title": {
                    "en": "Voluptatem omnis voluptatem illo vel et ducimus ipsa dolore quia inventore."
                },
                "description": {
                    "en": "Voluptatem itaque reiciendis qui ipsa qui aliquid. Sapiente esse corrupti debitis id dolor quia dolor occaecati. Dolorem dicta aperiam quia tempore voluptas."
                },
                "url": {
                    "en": "http://rolfson.com/reprehenderit-consequuntur-quo-laboriosam-explicabo-commodi.html"
                }
            }
        },
        {
            "id": 16,
            "name": "Prof. Pasquale Haley",
            "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": true
            },
            "only_order_in_store": true,
            "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": true
            },
            "seo": {
                "title": {
                    "en": "Enim cumque illum consectetur voluptatibus excepturi qui."
                },
                "description": {
                    "en": "Est nemo reprehenderit nobis quia repudiandae. Voluptatem iusto magni unde vel. Sunt iure sint consequatur doloribus. Enim aut quia adipisci sunt molestias."
                },
                "url": {
                    "en": "https://www.predovic.com/pariatur-reprehenderit-doloremque-atque-aut-aliquid-itaque-sint"
                }
            }
        },
        {
            "id": 12,
            "name": "Libby Padberg",
            "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": true
            },
            "only_order_in_store": true,
            "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": 19,
                "white_background": false
            },
            "seo": {
                "title": {
                    "en": "Ut consequatur fuga ratione dolorem odio molestias."
                },
                "description": {
                    "en": "Temporibus porro magnam deserunt optio neque aut quas. Rerum beatae culpa et et recusandae."
                },
                "url": {
                    "en": "http://www.sporer.com/molestias-dignissimos-atque-enim-aut-voluptates.html"
                }
            }
        }
    ],
    "category_groups": [
        {
            "name": "...",
            "category_ids": [
                16,
                14,
                15
            ],
            "id": 17,
            "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": 15,
                "white_background": true
            }
        },
        {
            "name": "...",
            "category_ids": [
                12,
                11,
                13
            ],
            "id": 13,
            "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": 12,
                "white_background": false
            }
        },
        {
            "name": "...",
            "category_ids": [
                11,
                13,
                19
            ],
            "id": 18,
            "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": 10,
                "white_background": false
            }
        }
    ],
    "allow_invoices": false,
    "category_groups_overview": true,
    "display_mode": "blocks",
    "takeout_use_intervals": false,
    "joyn_enabled": true,
    "category_overview": true,
    "fold_category_groups": false,
    "hours": [
        {
            "name": "...",
            "description": "...",
            "type": "open",
            "hours": [
                {
                    "days": "5",
                    "times": [
                        "09:45 - 17:49",
                        "09:45 - 17:49",
                        "09:45 - 17:49"
                    ]
                },
                {
                    "days": "5",
                    "times": [
                        "09:47 - 17:14",
                        "09:47 - 17:14",
                        "09:47 - 17:14"
                    ]
                },
                {
                    "days": "5",
                    "times": [
                        "09:10 - 21:29",
                        "09:10 - 21:29",
                        "09:10 - 21:29"
                    ]
                }
            ]
        },
        {
            "name": "...",
            "description": "...",
            "type": "open",
            "hours": [
                {
                    "days": "5",
                    "times": [
                        "09:45 - 11:48",
                        "09:45 - 11:48",
                        "09:45 - 11:48"
                    ]
                },
                {
                    "days": "5",
                    "times": [
                        "08:42 - 21:11",
                        "08:42 - 21:11",
                        "08:42 - 21:11"
                    ]
                },
                {
                    "days": "5",
                    "times": [
                        "07:18 - 12:50",
                        "07:18 - 12:50",
                        "07:18 - 12:50"
                    ]
                }
            ]
        },
        {
            "name": "...",
            "description": "...",
            "type": "open",
            "hours": [
                {
                    "days": "5",
                    "times": [
                        "08:11 - 16:21",
                        "08:11 - 16:21",
                        "08:11 - 16:21"
                    ]
                },
                {
                    "days": "5",
                    "times": [
                        "08:53 - 13:24",
                        "08:53 - 13:24",
                        "08:53 - 13:24"
                    ]
                },
                {
                    "days": "5",
                    "times": [
                        "06:50 - 18:51",
                        "06:50 - 18:51",
                        "06:50 - 18:51"
                    ]
                }
            ]
        }
    ],
    "contact": {
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE"
        },
        "telephone": "+32 475 00 00 00",
        "vat": "BE0123.456.789",
        "social": {
            "facebook": "https://example.com",
            "twitter": "https://example.com",
            "snapchat": "https://example.com",
            "instagram": "https://example.com",
            "pinterest": "https://example.com",
            "youtube": "https://example.com"
        },
        "website": "https://example.com",
        "email": "example@domain.com"
    },
    "messages": [
        {
            "name": "...",
            "title": "...",
            "text": "...",
            "type": "HTML"
        },
        {
            "name": "...",
            "title": "...",
            "text": "...",
            "type": "HTML"
        },
        {
            "name": "...",
            "title": "...",
            "text": "...",
            "type": "HTML"
        }
    ],
    "info": [
        {
            "name": "...",
            "title": "...",
            "text": "...",
            "type": "HTML"
        },
        {
            "name": "...",
            "title": "...",
            "text": "...",
            "type": "HTML"
        },
        {
            "name": "...",
            "title": "...",
            "text": "...",
            "type": "HTML"
        }
    ],
    "status": {
        "open": {
            "status": "closes-soon",
            "text": "..."
        },
        "takeout": "...",
        "delivery": "...",
        "latch": "..."
    },
    "has_specialties": false,
    "promotion": {
        "is_enabled": true,
        "title": "...",
        "type": "product",
        "id": 16,
        "custom_image_enabled": false,
        "photo": {
            "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": true
        }
    },
    "delivery": {
        "range": {
            "all_zipcodes": true,
            "has_max_range": true,
            "max_range": 12
        }
    },
    "currency": "EUR"
}
1.9.0 stable