A menu represents a type of response ONEm sends back to the user and it allows the user to select certain options you put in the menu.
It is composed by a header, a body and a footer. The body can contain option, content, login or logout items.
When an option is being accessed, ONEm platform will perform an HTTP request to the callback path you set.
All fields prefixed with a star (*) are required
A top level component used to display a menu or raw text
|*type||string||Indicates the type of the object, defaults to
|header||string||The header of the menu|
|footer||string||The header of the menu|
Menu related component used to display menu items, selectable or
|*type||string||Indicates the type of the object
|description||string||The displayed text for this
|method||string||HTTP method indicating how to trigger the callback path. Defaults to
|path||string||Next route callback path, accessed upon user selection
required only for
|src||string||Fully qualified public path to a media file. Be sure to include the file extension as this will be used to determine the type of media (image, audio or video). If
|alt||string||Alt text to use for media files when
'Cards' can be turned into selectable options by setting
Menu related component holding configuration fields for the menu
|auto_select||boolean||Will be automatically selected if set to
The response type should be equal to menu to indicate a menu response.
The header of the menu is indicated through header key. This value is not final and may be re-formatted by the ONEm platform depending on the user's access channel.
The body of the menu is indicated through body key and it is a sequence of objects. Each object can be an option or a content item and this is set through the type key. A content type item does not need a path nor a method since these are not selectable by the user. However an option item needs a callback path and this is relative to the callback_url set in the app schema in the ONEm Developer Portal. If the method is not present, it will default to GET.
A body composed of only content items could be used for display purposes only.
The footer of the menu is indicated through footer key and like the header of the menu, it is not final and may be altered (or even not displayed) by the ONEm platform depending on the user's access channel. If no footer is specified, the ONEm platform adds a default depending on the user's access channel.
The schema can also be found on Swagger Hub here
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39