Fret distance from the nut

Frammenti di codice

curl "https://api.oanor.com/guitar-api/v1/fret-position" \
  -H "x-oanor-key: oanor_test_..."

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

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

Risposta di esempio

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

{
    "data": {
        "note": "Fret distance from the nut = scale length × (1 − 2^(−fret/12)) — equal temperament, where each fret is the twelfth root of two higher in pitch. The 12th fret sits exactly halfway (the octave), and the frets crowd together toward the bridge. The rule of 18 (≈ 17.817) is the old luthier's approximation of the same maths.",
        "inputs": {
            "fret_number": 12,
            "scale_length_in": 25.5
        },
        "distance_from_nut_in": 12.75,
        "remaining_to_bridge_in": 12.75,
        "spacing_from_previous_in": 0.7582
    },
    "meta": {
        "timestamp": "2026-06-06T23:54:00.359Z",
        "request_id": "6a20607d-cb93-480a-b00f-e4c6c5a6c276"
    },
    "status": "ok",
    "message": "Fret position",
    "success": true
}