Migrating to API integration
Migrating Luigi's Box integrated services (via the LBX script) to the integration over API which you fully control is a risk-free operation in general. Follow these steps to complete the migration:
- Request a modified LBX script. Contact Luigi’s Box support to obtain a copy of the LBX script with the services you’re migrating disabled. For example, if you’re migrating recommenders to backend API calls but retaining the search integration, Luigi’s Box will provide an LBX script version with search integration active and recommender integration disabled.
- Deploy the modified script in your development and testing environments. Retain the original LBX script in your production environment to prevent any service disruption during development and testing.
- Develop the API integration. Implement and test the API calls. Refer to Search API and Recommender API for guidance.
- Release to production. When ready to release the API integration to production, deploy your code and keep the original production LBX script. Use Luigi’s Box’s emergency deactivation feature to disable frontend integration for the services you’ve launched via API, preventing interference between the old and new setups.
Tips & considerations
- Use browser developer tools (specifically the Network tab) to monitor the requests currently handled by Luigi’s Box, and replicate these in your API calls.
- Ensure consistency in user IDs (for personalization) and object identities when requesting recommendations. Inconsistent object identities are a common cause of unexpected results in backend integrations.