Today, Alexa Smart Properties (ASP) introduced a new ASP-CLI (Command Line Interface) tool, which is designed to simplify the process of integrating with the platform's REST APIs. This tool is released for ASP property administrators, ASP property operators, and ASP developers. With just one tool to download and configure, ASP property administrators can perform a variety of operations with a few lines of script — these would have previously required custom tool development.
Before today’s announcement, property administrators would use APIs to create, delete, modify, set settings to ASP properties, units, and devices. Integrating these APIs could be a complicated process that required administrators to allocate dedicated engineering resources.
The Command Line Interface wraps each ASP API within a command executable directly from a shell or script. For instance, executing asp-cli delete-all-reminders --unitid X is akin to integrating the API DELETE /v1/alerts/reminders?unitId={X} into a tool and executing it: this action removes all previously set reminders from devices linked to a specific unit (e.g., room) X. This operation is useful in properties with high guest turnover, preventing reminders meant for previous guests from reaching subsequent guests. Using the CLI tool, numerous simple administrative tasks concerning ASP properties, units, and devices can be completed within minutes, eliminating the need for days or weeks of integration effort. Examples of such operations include:
Examples of commands:
#1 asp-cli set-locales --endpointid $endpointid --value 'es-US'
#2 asp-cli get-endpoint-connectivity —endpointid $endpointid
#3 asp-cli enable-skill-multiple-units –skillid $skillid –unitids "$unitid1,$unitid2,…"
Illustration: example of a script to reset all settings and alarms in a room:
Key Benefits of the ASP-CLI:
The CLI can be used for command lines. Because it is distributed as source code, it can also be used as a library that you integrate to your own source code to expand the capabilities of your tools.
The CLI tool is distributed running on Node.js, and can run on Windows 11, Mac, Windows Server, Linux Client and Server, Lambda functions. To use it, install Node.js, download the CLI from the GitHub repo, and start using the commands provided in the cookbook and in the sample scripts. For a complete and detailed list of instructions, follow the README and COOKBOOK.