Spec

Frammenti di codice

curl "https://api.oanor.com/cycling-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/cycling-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/cycling-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/cycling-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "name": "Cycling Performance API",
        "notes": "Power model: (Crr·m·g·cosθ + m·g·sinθ + ½·ρ·CdA·v_air²)·v / efficiency. FTP zones are the Coggan/Allen levels. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/power",
                "params": {
                    "cda": "drag area m² (0.3)",
                    "crr": "rolling coeff (0.005)",
                    "grade": "% (default 0)",
                    "speed": "km/h",
                    "weight": "rider+bike kg",
                    "headwind": "km/h",
                    "efficiency": "0-1 (0.97)",
                    "air_density": "kg/m³ (1.225)"
                },
                "returns": "the power in watts and its breakdown"
            },
            {
                "path": "/v1/ftp-zones",
                "params": {
                    "ftp": "Functional Threshold Power in watts"
                },
                "returns": "the seven Coggan power zones"
            },
            {
                "path": "/v1/vam",
                "params": {
                    "time": "minutes",
                    "grade": "and %",
                    "speed": "or km/h",
                    "elevation": "m climbed"
                },
                "returns": "VAM (vertical ascent metres per hour)"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Cycling performance maths as an API. The power endpoint estimates the power in watts needed to ride at a given speed on a given gradient, from a physical model — rolling resistance, gravity on the climb, and aerodynamic drag — with sensible defaults you can override (rolling-resistance coefficient, drag area CdA, air density, drivetrain efficiency and headwind), and breaks the power down into its rolling, gravity and aero components plus watts-per-kilogram. The ftp-zones endpoint turns a Functional Threshold Power into the seven Coggan training zones (from active recovery to neuromuscular power) as watt ranges. The vam endpoint computes VAM — vertical ascent metres per hour, the climbing-speed metric — either from elevation gained and time, or from speed and gradient. Everything is computed locally and deterministically, so it is instant and private. Ideal for cycling and training apps, bike computers and power-meter tools, coaching, and route and climb analysis. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 4 endpoints. This is cycling maths; for running pace use a pace API and for heart-rate zones use a heart-rate API."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:04.808Z",
        "request_id": "dc10b5a2-1a91-4d6e-9f41-41216ca4bfa3"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}