What is the OrderingPlus API?
OrderingPlus is the best and easiest way to build any kind of OrderingPlus Solution. You can even create your Online OrderingPlus Marketplace; our APIs include all the power of our backend, so you don't need to build one to create amazing Apps or OrderingPlus Solutions.
Like any API, certain functions are defined that can be used to interact with your OrderingPlus project and utilize its resources.
Requirements for using the OrderingPlus API
OrderingPlus Project ID: The identifier should not contain spaces and must be in lowercase (It is automatically created based on your project name).
X-API-KEY: This key is used as authentication for requests made to the API. You can obtain it in your dashboard under the Settings/Pro/Developers/API Keys section/Add API key:
API Request Testing Tool: In this guide, we will use "Postman," but you can use any other similar tool.
Endpoint URL: In this guide, we will explain how to use the main endpoints.
Web browser with developer tools, such as Google Chrome
Get Order List
You can obtain the list of orders that belong to your project and apply filters to them
Usage example
Filters for Orders list
It's possible to retrieve the list of orders using specific filters. This allows for more specific order retrieval. Some of the filters that can be used include:
Status
Range date
Customer email
Usage example
Get Businesses List
You can obtain the complete list of your businesses from your project.
Usage example:
The easiest way to request the list of businesses is through the following endpoint:
NOTE: Don't forget to replace "<project_id>" with your project's identifier and <language_code> with “en” or with the code of your language.
Now, you simply need to use the endpoint using the "GET" request type and add your "x-api-key" as the "Authorization" of the request.
Usage example
When attempting this, you may encounter an error due to the potentially high payload of requested data in JSON format. To address this, parameters should be used.
For example, if we only want to request the "name" value of the business, we can add these parameters to the request. Additionally, we include "page=1&page_size=10" to limit the result per page:
Usage example
The API will return reduced information, including only some minimal data. If you want to add additional data, you just need to include it, for example, the "location":
We can also observe that the same endpoint is used in the dashboard but with additional parameters added. This can be useful for comparing information regarding the usage of certain endpoints:
Some parameters compatible with the business endpoint are:
external_id
featured
enabled
reviews
delivery_price
delivery_time
slug
pickup_time
categories: This parameter may increase the request load; we do not recommend using it for this endpoint.
Get Categories and Products from the Store
To get categories and product info, the following endpoint can be used:
To send this request, a "GET" method is used, and it requires using the Authorization with an x-api-key, as you can see in the following image:
Usage example
You can view the products within each category.
