Spec

Frammenti di codice

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

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

$ch = curl_init("https://api.oanor.com/weathercalc-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/weathercalc-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": "Weather Calculator API",
        "notes": "Wind chill: Environment Canada (metric) / NWS 2001 (imperial). Heat index: NWS Rothfusz. Dew point: Magnus (a=17.625, b=243.04°C). Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/wind-chill",
                "params": {
                    "temp": "temperature",
                    "unit": "metric (°C,km/h) | imperial (°F,mph)",
                    "wind": "wind speed"
                },
                "returns": "the wind-chill temperature"
            },
            {
                "path": "/v1/heat-index",
                "params": {
                    "temp": "temperature",
                    "unit": "metric|imperial",
                    "humidity": "relative humidity %"
                },
                "returns": "the heat index (apparent temperature)"
            },
            {
                "path": "/v1/dew-point",
                "params": {
                    "temp": "temperature",
                    "unit": "metric|imperial",
                    "humidity": "relative humidity %"
                },
                "returns": "dew point, vapour pressure and absolute humidity"
            },
            {
                "path": "/v1/beaufort",
                "params": {
                    "force": "or a Beaufort force 0-12",
                    "speed": "wind speed",
                    "speed_unit": "m/s|km/h|mph|knots"
                },
                "returns": "the Beaufort force and description (or speed range)"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Meteorological formulas as an API — the derived weather figures, computed from your own readings, with no data feed or key needed. The wind-chill endpoint gives the \"feels like\" cold using the Environment Canada formula in metric (°C, km/h) or the US NWS formula in imperial (°F, mph), and flags when it is outside the valid range. The heat-index endpoint gives the apparent temperature from heat and humidity using the NWS Rothfusz regression with the standard low- and high-humidity adjustments. The dew-point endpoint uses the Magnus formula to turn temperature and relative humidity into the dew point, and also returns the vapour pressure and absolute humidity. The beaufort endpoint maps a wind speed (m/s, km/h, mph or knots) to its Beaufort force and description, or a force back to its speed range. Everything is computed locally and deterministically, so it is instant and private. Ideal for weather apps and dashboards, agriculture and HVAC, marine and aviation, and outdoor and safety tools. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 5 endpoints. This computes weather formulas; for live forecasts and observations use a weather data API."
    },
…