Spec

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/musicnote-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/musicnote-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": {
        "name": "Music Theory API",
        "notes": "Equal temperament, A4 = 440 Hz. MIDI 0-127. C4 = middle C = MIDI 60. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/note",
                "params": {
                    "note": "name or MIDI number",
                    "flats": "spell with flats",
                    "frequency": "or a frequency in Hz"
                },
                "returns": "note name, MIDI number and frequency (and cents-off for a frequency)"
            },
            {
                "path": "/v1/interval",
                "params": {
                    "to": "a note",
                    "from": "a note"
                },
                "returns": "semitones, cents, interval name and frequency ratio"
            },
            {
                "path": "/v1/chord",
                "params": {
                    "root": "root note",
                    "quality": "major|minor|maj7|m7|dom7|dim|aug|sus4|…"
                },
                "returns": "the chord's notes"
            },
            {
                "path": "/v1/scale",
                "params": {
                    "root": "root note",
                    "scale": "major|minor|dorian|pentatonic_minor|…"
                },
                "returns": "the scale's notes"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Music-theory maths as an API, in equal temperament with A4 = 440 Hz and scientific pitch notation (C4 = middle C = MIDI 60). The note endpoint converts freely between a note name (A4, C#5, Eb3), a MIDI note number and a frequency — and when you pass a frequency it returns the nearest note and how many cents sharp or flat it is. The interval endpoint gives the distance between two notes in semitones and cents, its name (perfect fifth, major third, …) and the exact frequency ratio. The chord endpoint returns the notes, MIDI numbers and frequencies of a chord from a root and a quality (major, minor, dim, aug, sus, 6, 7, maj7, m7, dim7, m7b5, 9, …). The scale endpoint returns the notes of a scale or mode from a root (major, the three minors, the seven modes, pentatonics, blues, whole-tone, chromatic). Sharp or flat spelling is selectable. Everything is computed locally and deterministically, so it is instant and private. Ideal for music apps and games, synths and DAWs, ear-training and theory teaching, tuners and MIDI tools. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 5 endpoints. This is music theory; for track/artist search use a music API."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:12.227Z",
        "request_id": "b0f514a5-d65c-4010-86cc-af8ebc91f24b"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}