What is an API?
An API (Application Programming Interface) enables an application or service to access the functions or data of another application in a controlled way. The information is updated in real time, so you are in instant contact with the most enhanced and reliable information possible. So you save time and money.
At WALOMO, we have developed a powerful API to help our distributors integrate our products directly into their own systems:
- the catalogue with our products (characteristics, visuals, etc.)
- prices (your distributor purchase prices)
- stocks (in real time)
- restocking dates
- orders (available soon)
How do I connect to the WALOMO API?
Write to contact@walomo.com and request your API keys to obtain access and connect to WALOMO data in real time.
Why connect to the WALOMO API?
Connecting to the WALOMO API offers many benefits to our distributors, enabling them to improve their operational efficiency and enhance the user experience. Here are some of the key benefits:
- 1. Process automation: By integrating our API, distributors can automate a large proportion of their manual processes, such as order management, stock updates and order synchronisation. This not only reduces the risk of human error, but also saves precious time.
- 2. Real-time access to data: Thanks to our API, distributors can access the latest information in real time. This includes stock levels, new collections, current promotions and much more. This transparency enables better decision-making and greater responsiveness to customer requests.
- 3. Customisation and Flexibility: Our API is designed to be flexible, allowing retailers to tailor the integration to their specific needs. Whether you want to integrate our product catalogue into your online shop, or use our analysis tools to optimise your sales, our API offers infinite possibilities.
- 4. Improved Customer Experience: By integrating our services directly via the API, retailers can offer their customers a smoother, more consistent experience. For example, automatic inventory and price updates ensure that customers always have the most accurate information.
- 5. Security and Compliance: We understand the importance of data security. Our API is built with the highest security standards to ensure the confidentiality and integrity of the information exchanged. In addition, we ensure that all transactions comply with local and international regulations.
By connecting to the WALOMO API, retailers can not only streamline their operations, but also create new opportunities to engage and retain their customers. Join us today and discover how our API can transform the way you do business.
For more information on how to get started with our API, please see our technical documentation or contact our dedicated support team.
1. Introduction
This documentation provides detailed instructions on how to use Walomo specific APIs in Magento 2. API usage is a feature that allows data to be retrieved from the Magento server and allows the user to retrieve the information quickly.
2. Prerequisites
To use the Magento2 APIs, you need a tool like Postman.
In the rest of this document, we will use Postman as the reference tool in the screenshots.
Once the Postman application has been installed, follow these next steps to finalise the configuration:
-
Import the Walomo collection using the walomo-collection.json file
Create a new Walomo environment with the various variables: -
URL: type default -> value depending on the environment for example: https://www.walomo.com/rest/V1/
-
currentAccessToken : type default -> no value, it will be filled automatically
-
username : type default -> email of the front user
-
password : type secret -> front user password
-
Select the environment created
3. Generate a customer token
Url : {{URL}}integration/customer/token
Method: POST
JSON request body :
{
"username": "{{username}}",
"password": "{{password}}"
}
This request must be executed each time you want to use the API. The token generated is valid for 1 hour.
4. Retrieve product prices
Url : {{URL}}walomo/prices/me
Method: GET
Authorization : Bearer token (voir la rubrique « Générer un token client »)
This query retrieves all the prices produced according to the customer's commercial conditions.
5. Recovering product stocks
URL : {{URL}}walomo/stocks
Method : GET
Authorization : Bearer token (voir la rubrique « Générer un token client »)
This query retrieves all product stocks and restocking.
6. Retrieve product information
URL : {{URL}}walomo/products
Method : GET
Authorization : Bearer token (see ‘Generating a customer token’)
Params :
- Skus : List of skus separated by a vigula (not compulsory)
- Page: page number
This query retrieves product information. It returns 200 products by default and the page parameter allows you to page through the product collection and the filter allows you to filter on several skus.
7. Retrieve order information
URL : {{URL}} walomo/orders/me
Method : GET
Authorization : Bearer token (voir la rubrique « Générer un token client »)
Params :
- Page: page number
This query retrieves information about past orders. It returns 200 orders by default, and the page parameter is used to page through the product collection.
7. Récupérer les informations commandes
URL : {{URL}} walomo/orders/me
Method : GET
Authorization : Bearer token (voir la rubrique « Générer un token client »)
Params :
- Page : numéro de la pagination
Cette requête permet de récupérer les informations lié à ses commandes passées. Elle renvoie par défaut 200 commande et le paramètre page permet de paginer dans la collection produit.