HotsApi.net is an open Heroes of the Storm replay database where everyone can download replays. It stores replays in a public AWS S3 bucket (currently in "Requester pays" mode) and provides and API to query replay metadata. Use Hotsapi.Uploader (repo link) to upload your replay files.
Currently API is still in alpha and may change
HotsApi is a PHP/Laravel app so the easiest way to run it locally is using Homestead. Alternatively, you can use a cookbook from hotsapi.chef repo that can automatically install all the dependencies and configure webserver.
In addition to defaul homestead config you will need:
- Install heroprotocol parser:
cd /opt && sudo git clone https://github.com/Blizzard/heroprotocol.git - Make a globally availabe heroprotocol executable:
sudo ln -s /opt/heroprotocol/heroprotocol.py /usr/bin/heroprotocol - Make sure heroprotocol has executable permission
chmod +x /opt/heroprotocol/heroprotocol.py - Configure
.envfilecp .env.example .env - Run
composer install - Run
php artisan migrate - Make sure
storagedir is writable
- SSH into a clean Ubuntu 16.04 installation
- Clone a chef repo
git clone https://github.com/poma/hotsapi.chef.git cd hotsapi.chef- Create a chef config file
cp chef.example.json chef.json - Modify
chef.jsonif needed (test server should be able to start without any modifications) - Run chef
sudo ./bootstrap.sh
Pull requests are very much appreciated, with community involvement we could get much more features in much shorter time. You can see the list of current tasks in project page, you can freely pick one from "backlog" or "high priority" columns and start working on it.