Data Management | Getting Started
The process to get started with Data Management API is outlined in the table. Note that each step is its own process.
Step | Topic | Description |
|---|---|---|
1 | Steps to obtain an integrator token and additional information about our APIs. | |
2 | Information about our non-disclosure agreement (NDA) terms and conditions regarding endpoints. | |
3 | A list of prerequisites to complete before starting the integration development process. | |
4 | Use Data Management's endpoint query parameters. | |
5 | Use different filters to retrieve data. |
Data Management | Next Steps
After the initial set up is completed, review these additional topics on Data Management menu creation:
Topic | Description |
|---|---|
Lists and describes Data Management's endpoints and data models. | |
Describes the methods used to retrieve menu data and define the data objects Data Management uses for menu elements. | |
Describes how to use the Online Ordering product resource to get details about products and how to organize those products into a typical online menu structure. |
For information on Sequential Cart Deployment, see Enable Sequential Cart Deployment.
Query Parameters
Data Management API endpoint query parameters are listed below:
Parameter | Description |
|---|---|
| Defines the valid, effective date of returned entities. For Example: effective_date=20YY-07-26T14:04:42.766Z |
| The response only includes entities matching the criteria defined by the Example: $filter=product_entity_id eq objectid(586e6e9fc21cbd000119bd14) |
| Defines the number of returned entities. Useful for navigating large data sets. Example: $top=10 |
| Defines the number of entities to skip before returning entities. Useful for navigating large data sets. Example: $skip=10 |
| Defines the data sorting property. Useful for locating recent updates or new menu items. Example: $orderby=last_updated desc |
| Defines the properties of the returned entities. Useful for retrieving specific entities. For example, using Example: include_entities=['product-price','time-period'] |
| Defines the ID of the returned entities. Useful for locating specific menu pages or add-on items. Example: entity_ids=['5a591e77fcacfe00019a8067','5a591ae8fcacfe00019a802e'] |
Master, Current, and List Endpoints
Each resource includes /master, /current, and /list endpoints that retrieve data with different filters:
Endpoint | Description |
|---|---|
| The {{dm_url}}/product/master |
| The {{dm_url}}/product/current?effective_date=20YY-07-26T14:04:42.766Z |
| The {{dm_url}}/product/list?effective_date=20YY-07-26T14:04:42.766Z |