Profile

Estimate home altitude from where the athlete is

For filling in home altitude, including on an account with nothing to compare against yet. The location is used for this request only and is never stored or logged, and nothing is saved: send the altitude with PATCH /profile, as a typed-in value, once the athlete accepts it. Estimates are rationed per athlete.

post/profile/home-altitude/estimate

Request

  • Base URL: https://bodylab.lol/api/v1
  • URL: https://bodylab.lol/api/v1/profile/home-altitude/estimate
  • Auth: HTTP bearer

Headers

X-Client-Platformstring

The native client's platform, e.g. ios. Server-side and non-native callers omit it.

X-Client-Versionstring

The native client's own semver version. With X-Client-Platform, a version below that platform's minimum is refused with CLIENT_UPGRADE_REQUIRED (426).

Request body

Response

OK

outcomestring required

estimated: an altitude was worked out (see estimate). no_elevation: none could be found for the location. too_coarse: the location is too rough to say. no_location: there was no location to work from. Known values: estimated, no_elevation, too_coarse, no_location. Treat unknown values as "other".

Changes

No recorded changes to this operation across all 1 revision of this API.