API — afu.tools

Überblick

https://afu.tools/api/v1 liefert alles, was diese Seite anzeigt: Bandplan mit Klassenrechten, Relais mit Umkreissuche und CSV-Export, DOK-Verzeichnis, Prüfungstermine samt Feeds, Contestkalender, POTA- und SOTA-Referenzen, Ausbreitungsdaten und Rufzeichenabfragen.

Die Daten werden regelmäßig aus den amtlichen und verbandseigenen Quellen zusammengetragen und als fertige Schnappschüsse ausgeliefert. Welche Quelle wie oft nachgezogen wird, steht unten.

Grundregeln

Nur GETAntworten sind JSON in UTF-8. Ausnahmen sind die CSV-Exporte und die Feeds.
Ratenbegrenzung120 Anfragen je Minute und IP, für Rufzeichenabfragen 30, für CSV-Exporte 10. Darüber kommt Status 429 mit Retry-After.
Cross-Origin erlaubtDie API lässt sich direkt aus einer Webseite heraus aufrufen.
Fehlerformat{"error": "…", "status": 404}
Maschinenlesbar/api/v1/openapi.json. Eine Swagger-Oberfläche gibt es bewusst nicht, sie lädt ihre Skripte von einem fremden CDN nach.

Bandplan

GET/api/v1/bands

GET/api/v1/bands/20m

GET/api/v1/frequency/145.500

GET/api/v1/frequency/14070kHz

Liefert je Band die Zuweisungen nach Anlage 1 der Amateurfunkverordnung mit Status, zulässiger Leistung je Klasse und den Zusatzbestimmungen, dazu die Segmente des IARU-Bandplans. /frequency beantwortet die Frage, was an einer bestimmten Frequenz gilt.

Relais

GET/api/v1/repeaters?band=2m&mode=FM&near=JO50HB&km=50

GET/api/v1/repeaters?q=DB0

GET/api/v1/repeaters?source=fm-funknetz.de

GET/api/v1/repeaters/export.csv?format=chirp&near=JO50HB&km=50

GET/api/v1/repeaters/export.csv?format=yaesuprog&band=70cm

Gefiltert wird nach band, mode, source und mit q über Rufzeichen, Ort, Postleitzahl und Locator. near nimmt einen Locator oder lat,lon, mit Umkreis kommen Entfernung und Richtung mit zurück. Die CSV-Exporte lassen sich in CHIRP laden oder direkt in den Yaesu-Programmer.

Feld	Bedeutung
`tone_hz`	CTCSS-Frequenz in Hertz
`tone_mode`	`tone` nur senden, `tsql` auch auswerten, `dcs`, `1750`
`dcs`	DCS-Code, dreistellig
`call_1750`	Relais öffnet mit dem 1750-Hz-Rufton
`tone_raw`	ursprünglicher Text der Quelle, für unklare Angaben

Die Tonangaben pflegen die Betreiber selbst und sind entsprechend lückenhaft.

DOK und Ortsverbände

GET/api/v1/dok/B37

GET/api/v1/dok/B

GET/api/v1/dok?q=Hassberge

GET/api/v1/sdok?q=Aktivit

Prüfungstermine

GET/api/v1/exams?status=verfuegbar

GET/api/v1/exams?near=JO50HB&km=200&klasse=Klasse%20N

GET/api/v1/exams/history

GET/api/v1/exams/feed.rss?near=JO50HB&km=200

GET/api/v1/exams/feed.ics?status=alle

Die Feeds tragen dieselben Filter wie die Liste. status=alle nimmt auch ausgebuchte Termine mit, sonst kommen nur freie Plätze.

Contestkalender

GET/api/v1/contests?days=365

GET/api/v1/contests/feed.ics

Die Termine sind aus den veröffentlichten Ausschreibungsregeln berechnet, jeder Eintrag nennt die Regel und verlinkt die Ausschreibung.

Portabel

GET/api/v1/spots?near=JO50HB&km=25

GET/api/v1/spots?near=50.07,10.67&km=50&type=sota

GET/api/v1/solar

Rufzeichen

GET/api/v1/callsign/DK5DEN

GET/api/v1/callsigns?prefix=DK5

Ausgegeben werden Rufzeichen, Inhaber, Klasse, der in der amtlichen Liste genannte Ort und die Quellen. Anschriften, Koordinaten und Locator gibt die API nicht heraus. Eine Suche nach Namen und einen vollständigen Abzug gibt es nicht.

Rechnen und Zustand

GET/api/v1/locator?lat=50.07&lon=10.67

GET/api/v1/locator?locator=JO50HB

GET/api/v1/distance?from=JO50HB&to=JN47

GET/api/v1/health

GET/api/v1/stats

Beispiel

$ curl -s 'https://afu.tools/api/v1/frequency/145.500' | jq '.band, .allocation.classes'
"2m"
{
  "A": { "value": 750, "unit": "PEP" },
  "E": { "value": 75,  "unit": "PEP" },
  "N": { "value": 6.1, "unit": "ERP" }
}

Woher die Daten kommen

Bereich	Quelle	Auffrischung
Frequenzen und Leistung	Anlage 1 der Amateurfunkverordnung	bei Änderung
Bandsegmente	IARU Region 1	selten
Relais	fm-funknetz.de, repeatermap.de	alle sechs Stunden
Rufzeichen	Rufzeichenliste der Bundesnetzagentur, ergänzt um QRZ.com	nächtlich
DOK und Ortsverbände	DARC	nächtlich
Prüfungstermine	Bundesnetzagentur	nächtlich
POTA und SOTA	POTA, SOTA, Flächen aus OSM, BfN und EEA	täglich
Ausbreitung	hamqsl.com (N0NBH)	halbstündlich
Contestkalender	Ausschreibungen der Veranstalter	berechnet

Die API ist ein Nebenprodukt dieser Seite und keine zugesicherte Leistung. Wer sie in etwas einbaut, das laufen muss, sollte Antworten zwischenspeichern und mit Ausfällen rechnen. Bei Fragen oder wenn eine Datenquelle fehlt: Kontakt.