Spec

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/degreeday-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/degreeday-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "notes": "Temperatures in °C (base typically 15.5–18 °C), UA in W/K. Degree-days are a simple proxy for heating/cooling demand; mean = (min+max)/2 is the standard daily estimate.",
        "service": "degreeday-api",
        "formulae": {
            "cdd": "CDD = max(0, mean − base)",
            "hdd": "HDD = max(0, base − mean)",
            "energy": "delivered_kWh = UA·DD·24/1000,  input = delivered/efficiency"
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/daily": "HDD and CDD for one day from a mean (or min+max) temperature against a base.",
            "GET /v1/energy": "Heating energy and cost from degree days and a heat-loss coefficient (UA).",
            "GET /v1/period": "Total HDD/CDD over a list of daily temperatures, with heating/cooling day counts."
        },
        "description": "Heating and cooling degree-day calculator: daily and period HDD/CDD from temperatures, and an energy/cost estimate from a heat-loss coefficient."
    },
    "meta": {
        "timestamp": "2026-06-04T18:38:24.017Z",
        "request_id": "3abad411-49eb-4c57-a763-7be555314194"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}