Spec

Codefragmenten

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

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

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

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste health check.

{
    "data": {
        "name": "Sound Level API",
        "notes": "Power: dB = 10·log₁₀(ratio). Amplitude/pressure: dB = 20·log₁₀(ratio). Levels combine by energy. Speed of sound ≈ 331.3·√(1+T/273.15) m/s. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/decibel",
                "params": {
                    "type": "power (10log) | amplitude (20log)",
                    "ratio": "a linear ratio (-> dB)",
                    "decibels": "or a dB value (-> ratio)"
                },
                "returns": "the conversion"
            },
            {
                "path": "/v1/combine",
                "params": {
                    "mode": "add | subtract",
                    "levels": "list of dB values"
                },
                "returns": "the combined sound level"
            },
            {
                "path": "/v1/distance",
                "params": {
                    "level": "dB at the first distance",
                    "to_distance": "d2",
                    "from_distance": "d1"
                },
                "returns": "the level at the new distance"
            },
            {
                "path": "/v1/wavelength",
                "params": {
                    "speed": "or speed of sound m/s",
                    "frequency": "Hz",
                    "wavelength": "or metres",
                    "temperature": "air °C (default 20)"
                },
                "returns": "the wavelength/frequency and speed of sound"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Acoustics and decibel maths as an API. The decibel endpoint converts between a linear ratio and decibels, in either the power convention (10·log₁₀) or the amplitude/pressure convention (20·log₁₀), in both directions. The combine endpoint adds sound levels the way real (incoherent) sources combine — by energy summation, so two equal 80 dB sources give 83 dB, not 160 — and can also subtract a known source from a total. The distance endpoint applies the inverse-square law to a point source in a free field (−6 dB per doubling of distance) to find the level at a new distance. The wavelength endpoint converts between frequency and wavelength for sound, deriving the speed of sound from the air temperature (or a value you give). Everything is computed locally and deterministically, so it is instant and private. Ideal for audio engineering and live sound, room and architectural acoustics, noise assessment, and physics teaching. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 5 endpoints. This is acoustics maths; for electrical circuits use an Ohm's-law API and for unit conversion use a unit API."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:09.931Z",
        "request_id": "b359516
…