A dashboard to support Openactive API users/publishers.
If you have docker installed you can build and launch the API Dashboard with the
dockerize.sh script. All you need to do is clone the repository and from the project directory run the script:
- Install docker
git clone https://github.com/openactive/api-dashboard.git
Getting started with development
To manage versions of Ruby we recommend installing rbenv or rvm.
Once you have the requisite ruby version, install gems using
bundle install. Once installed you should be able to launch the application with the command
bundle exec rackup. The application should be available at:
For the application to work you will also need to have a redis server running. The application will try to connect to the default redis host and port (
127.0.0.1:6379). Alternatively, you can specify the host and port with the environment variables
OA_REDIS_PORT. NB the application reads these, and other environment variables in
The API Dashboard use the Rspec test suite. To run the tests install the testset gems with
bundle install, and then run
bundle exec rspec.
Command Line Tools
There is a script you can run to update the dashboard metadata. To run:
bundle exec ./bin/update_metadata.rb
Or on Heroku:
heroku run bundle exec ./bin/update_metadata.rb
This script checks if the metadata has been updated recently. If you want to force it to update, provide an
-f flag, e.g.:
bundle exec ./bin/update_metadata.rb -f
There is a script you can run to update the dataset summaries. To run:
bundle exec ./bin/update_summaries.rb
Or on Heroku:
heroku run bundle exec ./bin/update_summaries.rb
This script pages through the data and saves the page where it stopped. Subsequent updates will pick up where it left off.
If you want to build a summary sampling from the first page you can provide the
--restart option to restart from the beginning. E.g.
bundle exec ./bin/update_summaries.rb --restart
If you want to clear the summary, but coninue from the last page, you can provide the
--last-page-restart option e.g.
bundle exec ./bin/update_summaries.rb --last-page-restart
Contains National Statistics data © Crown copyright and database right