API docs by Redocly

Menu API (1.0)

Download OpenAPI specification:Download

OrderingStack menu API

menu definition

getMenu

Get menu definition by ID.

Authorizations:
oauth2-clientoauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default

Responses

putMenu

Update menu definition. ID in input document is overridden by the one from path. This method does upsert in database.

Authorizations:
oauth2-clientoauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default
Request Body schema: application/json
required
id
required
string[a-zA-Z0-9_.-]+
object

Map key refers to possible order types, like 'DELIVERY', 'TAKE_AWAY', 'DINE_IN', etc.

Responses

Request samples

Content type
application/json

basic

{
  • "id": "MENU_default",
  • "specific": {
    }
}

deleteMenu

Delete menu definition by ID.

Authorizations:
oauth2-clientoauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default

Responses

definitionsList

Get paginated list of Menu definitions (menu sets assigned to venues). This endpoint is compatible with React AdminOnRest framework to provide DataSource.

Authorizations:
oauth2-clientoauth2
query Parameters
required
object (DefinitionsFilter)

Responses

postMenu

Create new menu definition. If ID is not provided it will be generated. Otherwise this method is similar to PUT method and does upsert in database.

Authorizations:
oauth2-clientoauth2
Request Body schema: application/json
required
id
required
string[a-zA-Z0-9_.-]+
object

Map key refers to possible order types, like 'DELIVERY', 'TAKE_AWAY', 'DINE_IN', etc.

Responses

Request samples

Content type
application/json

basic

{
  • "id": "MENU_default",
  • "specific": {
    }
}

items

getItem

Retrieve menu item by ID from database.

Authorizations:
oauth2-clientoauth2
path Parameters
item
required
string[a-zA-Z0-9_.-]+
Example: espresso

Responses

putItem

Update menu item. ID from path overrides the one provided in input object. Method does upsert in database.

Authorizations:
oauth2-clientoauth2
path Parameters
item
required
string[a-zA-Z0-9_.-]+
Example: product-id
query Parameters
optimistic-lock
string <date-time>
Request Body schema: application/json
required
id
string[a-zA-Z0-9_.-]+
object
kind
required
string
reference
required
string

Responses

Request samples

Content type
application/json
Example

category

{}

deleteItem

Deletes menu item by id. Be carefull when deleting items as they may be referenced by References in other items.

Authorizations:
oauth2-clientoauth2
path Parameters
item
required
string[a-zA-Z0-9_.-]+
Example: product-id
query Parameters
optimistic-lock
string <date-time>

Responses

validateProducts

Validate products. Validates products with provided configuration of options and sub-products against product definition, current locks, etc. It also generates ProductDescription on successful validation.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
time
required
string <date-time>
Example: time=2021-01-01T10:10:00Z
tz
required
string

Timezone for calculations

Request Body schema: application/json
required
additional property
object (ValidateProduct)

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

previewProduct

Preview product. Resolves references and queries to provide full product config. Nothing more (i.e. pricelists, prices and locks) is calculated here so that no sub-products are removed. Bear in mind that final product may not contain some of options due to those additional computations.

Authorizations:
oauth2-clientoauth2
query Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: menu=DEFAULT_menu

Menu identifier for computations.

channel
string [ 1 .. 32 ] characters [A-Z0-9_]+
Default: "DELIVERY"
Example: channel=DELIVERY

Channel used in menu computations.

instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
Request Body schema: application/json
required
id
string[a-zA-Z0-9_.-]+
object
kind
required
string
reference
required
string

Responses

Request samples

Content type
application/json

sample

{}

validateProduct

Validate single product. Validates product with provided configuration of options and sub-products against product definition, current locks, etc. It also generates ProductDescription on successful validation.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
product
required
string[a-zA-Z0-9_.-]+
Example: product=product-id-1
time
required
string <date-time>
Example: time=2021-01-01T10:10:00Z
tz
required
string

Timezone for calculations

Request Body schema: application/json
object

Selected items.

object

Merged filter based on emitted filters matching selected items.

Responses

Request samples

Content type
application/json
Example

empty

{ }

itemsList

Get paginated list of MenuItems. This endpoint is compatible with React AdminOnRest framework to provide DataSource.

Authorizations:
oauth2-clientoauth2
query Parameters
required
object (ItemsFilter)

Responses

postItem

Create new menu item. If ID is not provided it will be generated. Otherwise this method is similar to PUT method and does upsert in database.

Authorizations:
oauth2-clientoauth2
Request Body schema: application/json
required
id
string[a-zA-Z0-9_.-]+
object
kind
required
string
reference
required
string

Responses

Request samples

Content type
application/json
Example

category

{}

menuItem

Get single product definition. Returns product definition by its ID. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
product
required
string[a-zA-Z0-9_.-]+
Example: product-id-1
query Parameters
channel
required
string[A-Z0-9_]+
Example: channel=DELIVERY
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

menuItems

Get multiple products definition. Returns definitions of products by their IDs. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
product
required
Array of strings [ 0 .. 20 ] items [ items[a-zA-Z0-9_.-]+ ]
Example: product=product-id-1
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

menuItem_1

Get single product definition. Returns product definition by its ID. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
product
required
string[a-zA-Z0-9_.-]+
Example: product-id-1
query Parameters
channel
required
string[A-Z0-9_]+
Example: channel=DELIVERY
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

search

Search for products by partial string (suggest). Returns all products which id, name or description literals contains provided string. It tries to determine locale by Accept-Locale request header and checks also name-[LOCALE] and description-[LOCALE] literals.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
required
object (SearchParams_Public)

Responses

menuItems_1

Get multiple products definition. Returns definitions of products by their IDs. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
product
required
Array of strings [ 0 .. 20 ] items [ items[a-zA-Z0-9_.-]+ ]
Example: product=product-id-1
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

suggestItemsList

Fetch suggest list

Authorizations:
oauth2-clientoauth2
query Parameters
required
object (SuggestItemsFilter)

Responses

menu

validateProducts

Validate products. Validates products with provided configuration of options and sub-products against product definition, current locks, etc. It also generates ProductDescription on successful validation.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
time
required
string <date-time>
Example: time=2021-01-01T10:10:00Z
tz
required
string

Timezone for calculations

Request Body schema: application/json
required
additional property
object (ValidateProduct)

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

validateProduct

Validate single product. Validates product with provided configuration of options and sub-products against product definition, current locks, etc. It also generates ProductDescription on successful validation.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
product
required
string[a-zA-Z0-9_.-]+
Example: product=product-id-1
time
required
string <date-time>
Example: time=2021-01-01T10:10:00Z
tz
required
string

Timezone for calculations

Request Body schema: application/json
object

Selected items.

object

Merged filter based on emitted filters matching selected items.

Responses

Request samples

Content type
application/json
Example

empty

{ }

menuItem

Get single product definition. Returns product definition by its ID. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
product
required
string[a-zA-Z0-9_.-]+
Example: product-id-1
query Parameters
channel
required
string[A-Z0-9_]+
Example: channel=DELIVERY
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

menuItems

Get multiple products definition. Returns definitions of products by their IDs. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
product
required
Array of strings [ 0 .. 20 ] items [ items[a-zA-Z0-9_.-]+ ]
Example: product=product-id-1
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

menuCacheSynchronized

Get menu definition. Returns whole menu with evaluated references and queries. Also returns currently defined locks for instance.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
variant
string[AB]
Default: "A"
Example: variant=A

Responses

menu

Get menu definition. Returns whole menu with evaluated references and queries. Also returns currently defined locks for instance.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
variant
string[AB]
Default: "A"
Example: variant=A

Responses

menuItem_1

Get single product definition. Returns product definition by its ID. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
product
required
string[a-zA-Z0-9_.-]+
Example: product-id-1
query Parameters
channel
required
string[A-Z0-9_]+
Example: channel=DELIVERY
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

search

Search for products by partial string (suggest). Returns all products which id, name or description literals contains provided string. It tries to determine locale by Accept-Locale request header and checks also name-[LOCALE] and description-[LOCALE] literals.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
required
object (SearchParams_Public)

Responses

menuItems_1

Get multiple products definition. Returns definitions of products by their IDs. All references are evaluated.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: DEFAULT_menu
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
product
required
Array of strings [ 0 .. 20 ] items [ items[a-zA-Z0-9_.-]+ ]
Example: product=product-id-1
instance
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
header Parameters
Accept-Encoding
string

Responses

menuSimplified2

Get simplified menu definition (v2). Returns categories and products without full product configuration. This endpoint does not return locks.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
variant
string[AB]
Default: "A"
Example: variant=A

Responses

menuSimplified2_1

Get simplified menu definition (v2). Returns categories and products without full product configuration. This endpoint does not return locks.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
variant
string[AB]
Default: "A"
Example: variant=A

Responses

menuSimplified

Get simplified menu definition. Returns categories and products without full product configuration.

Authorizations:
oauth2
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
variant
string[AB]
Default: "A"
Example: variant=A

Responses

menuReport

Generate report of removed items in menu.

Authorizations:
oauth2-client
path Parameters
menu
required
string[a-zA-Z0-9_.-]+
Example: MENU_default
query Parameters
channel
required
string [ 1 .. 32 ] characters [A-Z0-9_]+
Example: channel=DELIVERY
instance
required
string[a-zA-Z0-9_.-]+
Example: instance=venue-1
variant
string[AB]
Default: "A"
Example: variant=A

Responses

locks

locksList

Get paginated list of Locks. This endpoint is compatible with React AdminOnRest framework to provide DataSource.

Authorizations:
oauth2-clientoauth2
query Parameters
required
object (LocksFilter)

Responses

postLock

Create new lock. Its ID must be new and unique. Overriding existing locks is not allowed. To alter a lock simply delete old one and create new.

Authorizations:
oauth2-clientoauth2
Request Body schema: application/json
required
id
required
string [ 3 .. 128 ] characters [a-zA-Z0-9_.-]+

ID of this lock.

products
Array of strings [ 1 .. 2147483647 ] items [ items [ 0 .. 128 ] characters [a-zA-Z0-9_.-]+ ]

IDs of locked products.

instances
Array of strings[ items [ 0 .. 128 ] characters [a-zA-Z0-9_.-]+ ]

Instances (venues) where this lock is applied.

object

Channels (like DINE_IN, DELIVERY, etc).

description
string

Lock description

plannedLockExpirationDate
string <date-time>

Planned date of lock expiration

lockReason
string

Lock reason

Responses

Request samples

Content type
application/json

basic

{
  • "id": "product_lock_1",
  • "products": [
    ],
  • "instances": [
    ],
  • "lockedInChannel": [
    ]
}

getLock

Get lock definition by id

Authorizations:
oauth2-clientoauth2
path Parameters
lock
required
string[a-zA-Z0-9_.-]+

Responses

deleteLock

Remove lock with provided ID.

Authorizations:
oauth2-clientoauth2
path Parameters
lock
required
string[a-zA-Z0-9_.-]+

Responses

locks

Get currently set locks for instance (i.e. venue). Returns all locks with matching instance and global locks (without any instance assigned)

Authorizations:
oauth2
path Parameters
instance
required
string[a-zA-Z0-9_.-]+
Example: venue-1

Responses

export

importMenu

Import menu.

Authorizations:
oauth2-clientoauth2
query Parameters
clean
boolean
Default: true

Responses

exportMenu

Export menu.

Authorizations:
oauth2-clientoauth2

Responses

cache

clearGenerateMenuLocks

Reset generate menu locks.

Authorizations:
oauth2

Responses

resetCache

Reset menu cache.

Authorizations:
oauth2

Responses

bomKeys

bomKeysList

Get paginated list of BomKey. This endpoint is compatible with React AdminOnRest framework to provide DataSource.

Authorizations:
oauth2-clientoauth2
query Parameters
required
object (BomKeysFilter)

Responses

postBomKey

Create new bom key. Bom key must be new and unique. Overriding existing bom key is not allowed. To alter a bom key simply delete old one and create new.

Authorizations:
oauth2-clientoauth2
Request Body schema: application/json
required
id
required
string [ 2 .. 128 ] characters [\p{L}\p{N}_.-]+

BOM key

Responses

Request samples

Content type
application/json

basic

"{\n \"id\" : \"bom_key\",\n}"

deleteBomKey

Remove bom key

Authorizations:
oauth2-clientoauth2
path Parameters
id
required
string[\p{L}\p{N}_.-]+

Responses