Public API

The API is free and open: you can build and sell any apps you want. Also, there’s no restrictions on the logo and style usage. By using this API you accept the terms of use.


Cadence data receiving endpoint
URL http://ambalco.com/sensor/
request method POST
Required parameters
nick The Nickname is used to sync cadence data only, it is not an authorization.
cadence Integer from 0 to 200, cranks rotations per minute. The full 360O rotation counts. Normally, this value is used by the BikeTube to calculate power and speed.
salt Random 8 chars string, generated upon the installation, on the first app run. This string is persistent and it is used to track the device: if one user uses nick "Foobar" right now, the user with another salt will be requested to enter another nick
Optional parameters (coming soon)
power If your app is advanced enough to measure the power the cyclist generates, you can submit this parameter. This param overrides the value calculated by the BikeTube.
heart_rate If your app measures the heart rate with bluetooth or ant sensors, you can submit this data too, and it will be displayed on the big screen on the video overlay gauges.
Response
power Status message, showing estimated power for the given cadence or syncronization failure human-readable explanation
comment More detailed status message, containing some debug data
need_nick returns 0 if nick is ok or 1 if nick is in use and another nick needed

Playground

Request

nick
cadence
salt

Response

Add YouTube video

to make it into the game