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. |
| club | Used to sync cadence data when in club mode (multiplayer). |
| 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 | |
| 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 Ambalco game engine. IMPORTANT: if your app or device doesn't measure the power, send -1 as a dummy value. Do not send 0. |
| 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 club cadence* salt* power heart rate | Response |
