The Boxalino Real Time User Experience (RTUX) API integration guidelines
This package is auto-updated.
Last update: 2022-05-16 02:19:43 UTC
For the PHP integration, Boxalino comes with a divided approach: framework layer, data export layer and integration layer. The current repository is used as aN integration layer.
This repository is a test-framework for the API requests, response and the API library. With the use of Docker, will create a symfony web-server on which the API requests can be tested. The response is returned raw JSON
This repository is not subject to Boxalino maintenance on client setup. This means, the guidelines are supposed to be integrated in a repository/plugin maintainted & developed by the client`s team.
This repository can be deployed for testing Boxalino features or in order to prepare your own integration. In order to deploy it as is in a local environment, check the Setup steps bellow.
You are able to use the repository if:
- you have access to Boxalino API credentials
- a data index is available for your Boxalino account
- narratives and layout blocks have been designed in the Boxalino Intelligence admin
The latest documentation is available in the wiki.
Clone/Fork the repository
Create the environment file (.env) based on .env.dist and set the credentials
Run the CLI image and do a composer update to install dependencies
docker-compose run --rm cli-setup /bin/bash
Launch the Symfony web server
docker-compose up -d app
Check the port that`s assigned to component's port 8000
docker ps -a | grep 8000/tcp
Check the API response / request for each use-cases:
- listing : /navigation/
- search : /search/?query=&page=&order=&sort=
- product recommendation : /product/
- basket recommendation : /cart/?product_id=&other_cart_ids=<id|id|id>
- autocomplete : /autocomplete?query=
If you have any question, just contact us at firstname.lastname@example.org