DTMF-Tonfrequenzen für Telefontasten nachschlagen
Ein DTMF-Ton stellt eine Telefontaste durch zwei gleichzeitig abgespielte Frequenzen dar: Eine stammt aus einer niederfrequenten Zeile, die andere aus einer hochfrequenten Spalte.
Im Browser ausführen – kostenlos
Geben Sie eine Ziffer von 0 bis 9, den Stern oder die Raute ein, um das exakte Standardpaar in Hertz zu erhalten. Die Abfrage ist deterministisch und sofort verfügbar. Damit prüfen Sie Telefoniesoftware, Tongeneratoren, Decoder, Dokumentationen und Testdaten, ohne eine Tastaturmatrix von Hand nachzuschlagen.
Wie aus einer Taste zwei Frequenzen werden
Das Mehrfrequenzwahlverfahren, meist als DTMF bezeichnet, ordnet die Telefontastatur als Frequenzmatrix an. Jede waagerechte Zeile besitzt eine niedrige Frequenz und jede senkrechte Spalte eine hohe Frequenz. Wenn Sie eine Taste drücken, werden die Frequenzen ihrer Zeile und Spalte kombiniert. Dadurch erhält jede Position ein charakteristisches Paar. Die Tasten 1, 2 und 3 verwenden beispielsweise dieselbe niedrige Zeilenfrequenz, aber unterschiedliche hohe Spaltenfrequenzen. Diese Abfrage gibt beide Bestandteile getrennt und zusätzlich als geordnetes Paar aus, wobei die niedrige Frequenz zuerst steht. Diese Struktur eignet sich sowohl zum Lesen einer Spezifikation als auch für Programme, die einen Oszillator, einen Detektor oder eine Testbedingung vorbereiten. Das Ergebnis nennt Frequenzen in Hertz; es erzeugt keine Audiodatei, schätzt keine Tondauer und analysiert keine Aufnahme. Da die Tabelle durch den üblichen DTMF-Tastaturplan festgelegt ist, liefert dieselbe zulässige Taste stets dasselbe Ergebnis. Dabei gibt es weder Rundungen noch Netzwerkzugriffe oder geräteabhängige Berechnungen.
Welche Zeichen der Tastatur zulässig sind
Die Eingabe muss genau ein Zeichen einer üblichen Telefontastatur mit 12 Tasten sein: eine Ziffer von 0 bis 9, der Stern oder die Raute. Das Zeichen wird wörtlich ausgewertet. Bei einem API-Aufruf sollten Sie eine Ziffer deshalb als Text übermitteln. Leerzeichen, Wörter, mehrere Zeichen, Minuszeichen und andere Satzzeichen als die beiden Tastatursymbole führen zu einem Eingabefehler. Manche technischen DTMF-Spezifikationen beschreiben außerdem eine vierte Spalte mit den Steuertasten A, B, C und D. Diese Tasten kamen in speziellen militärischen Geräten und in Netzsteuerungssystemen vor, gehören jedoch nicht zur hier behandelten Standardtelefontastatur. Sie werden daher bewusst abgelehnt. Die enge Auswahl verhindert falsche Annahmen über die verwendete Anordnung. In einem Formular können Sie die deklarierten Werte als Auswahlliste darstellen. Bei einer Programmintegration sollten Sie die gewünschte Taste vor dem Senden ausdrücklich prüfen oder in Text umwandeln, statt sich auf eine automatische Zahlenumwandlung zu verlassen.
Das Ergebnis in Telefonieprojekten einsetzen
Die ausgegebenen niedrigen und hohen Frequenzen dienen überall dort als Referenzdaten, wo Software mit einer Telefontastatur übereinstimmen muss. Ein Tongenerator kann das Paar verwenden, um zwei Oszillatoren einzustellen, bevor eigene Vorgaben für Amplitude, Abtastrate und Dauer angewendet werden. Ein Decodertest kann ein bekanntes Paar mit der Taste verknüpfen, die erkannt werden soll. Qualitätssicherungsteams können die Antwort in stabile Testdaten für Sprachdialogsysteme, Wählprogramme, Softphones, Gateways und eingebettete Geräte übernehmen. Die Abfrage erklärt außerdem mögliche Verwechslungen benachbarter Tasten: Tasten derselben Zeile teilen sich die niedrige Komponente, Tasten derselben Spalte die hohe. Diese Funktion beurteilt weder Pegelunterschiede noch Toleranz, Taktung, Signalstärke oder die Normkonformität einer Aufnahme. Solche Fragen erfordern Messungen am tatsächlichen Signal. Ausgegeben wird ausschließlich die nominelle Frequenzzuordnung. Für eine gelegentliche Kontrolle können Sie die Funktion im Browser ausführen. Wenn ein Arbeitsablauf eine kleine, vorhersehbare JSON-Antwort benötigt, rufen Sie die API für $0.002 je Anfrage auf.
Anwendungsfälle
Einen DTMF-Tongenerator konfigurieren
Rufen Sie die nominellen niedrigen und hohen Oszillatorfrequenzen für die Taste ab, die Ihre Anwendung ausgeben soll.
Testdaten für Decoder erstellen
Erstellen Sie eindeutige Sollwerte, die ein Tastaturzeichen seinem standardmäßigen Frequenzpaar zuordnen.
Telefoniedokumentation kontrollieren
Bestätigen Sie ein Frequenzpaar bei der Prüfung von IVR-Abläufen, Wählprogrammen, Gateway-Einstellungen oder technischen Hinweisen.
Häufige Fragen
Welche Zeichen können Sie eingeben?
Geben Sie genau eine Ziffer von 0 bis 9, einen Stern oder eine Raute ein.
Warum werden die DTMF-Tasten A, B, C und D abgelehnt?
Sie gehören zu einer speziellen vierten DTMF-Spalte und sind auf der hier behandelten üblichen Telefontastatur mit 12 Tasten nicht vorhanden.
Erzeugt dieses Werkzeug einen hörbaren Ton?
Nein. Es gibt das nominelle Frequenzpaar als Daten zurück und erzeugt, spielt oder lädt keine Audiodatei herunter.
Kann es eine Aufnahme von Tastentönen analysieren?
Nein. Eine Audioanalyse erfordert einen Decoder, der die Frequenzen im Signal misst. Diese Funktion schlägt nur das Paar einer bekannten Taste nach.
Was kostet eine API-Anfrage?
Jede API-Anfrage kostet $0.002. Dieselbe deterministische Abfrage kann auch in Ihrem Browser ausgeführt werden.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/audio/dtmf-tone-lookup \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"key":"5"}'const res = await fetch("https://api.kit.forhosting.com/audio/dtmf-tone-lookup", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"key": "5"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/audio/dtmf-tone-lookup",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"key": "5"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/dtmf-tone-lookup", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"key":"5"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"key":"5"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/dtmf-tone-lookup", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"key": "5"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "audio.dtmf_tone_lookup",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_mb | 200 |
max_minutes | 180 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |