Schnittstellen und Daten

Alle Angaben von Skatefinder lassen sich maschinell abrufen: ohne Anmeldung, ohne Schlüssel, von jeder Herkunft (CORS erlaubt). Alle Endpunkte sind nur lesend. Die Antworten sind Deutsch, Zahlen und Datumsangaben im JSON-Format (Datum als JJJJ-MM-TT).

Wer die Daten verwendet, nennt skatefinder.smarterwolf.de (WOLFSOFT).

Auf einen Blick

Schema: /api/openapi.json (OpenAPI 3.1)
Kurzfassung für KI-Werkzeuge: /llms.txt, gesamter Bestand als Text: /llms-full.txt
Textfassungen: jede Strecke und jeder Treff hat unter seiner Adresse mit angehängtem .md eine Markdown-Fassung (/strecke/<slug>.md, /treff/<slug>.md), alle Termine stehen in /termine.md
Kalender zum Abonnieren: /api/termine.ics, ein einzelner Termin unter /api/termine/<id>.ics
Tempolimit: 60 Anfragen je Minute und Adresse unter /api/ (kurze Spitzen bis 60 mehr werden durchgelassen); danach antwortet der Server mit 429. Diese Seite und die Textfassungen zählen nicht darunter.
Zwischenspeicher: Antworten dürfen 5 Minuten gemerkt werden (Cache-Control: public, max-age=300).

Endpunkte

GET /api/strecken

Veröffentlichte Strecken im Umkreis eines Punktes, nach Entfernung sortiert, mit vereinfachter Linie als GeoJSON.

Parameter (alle optional): lat, lon (Standard: Neuwied), radius_km (Standard 50, höchstens 1000), min_asphalt (0 bis 1), laenge_min_km, laenge_max_km, hm_max (Höhenmeter aufwärts), rundkurs (true/false), schwierigkeit_max (0 bis 3), art (dauerhaft oder aktionstag).

Wichtige Felder je Strecke: slug, name, stand, laenge_km, hoehenmeter, anteil_asphalt (0 bis 1), schwierigkeit (stufe 0 bis 3 und name), belag, rundkurs, nur_am_aktionstag, naechster_termin, entfernung_km, linie.

curl -s "https://skatefinder.smarterwolf.de/api/strecken?lat=50.43&lon=7.46&radius_km=30&min_asphalt=0.9"

GET /api/strecken/{slug}

Alle Angaben zu einer Strecke. Zusätzlich zu den Feldern der Liste: beschreibung_html, quelle_text, quelle_url, hoehenmeter_ab, max_steigung, max_gefaelle, anteil_kfz_strasse, profil (Liste aus Teilstück, km, Höhe), warnungen, abschnitte (Belag, Wegart und Linie je Abschnitt), punkte (Wegpunkte mit Fotos) und die Begründung der Schwierigkeit. Unbekannte Strecke: 404.

curl -s https://skatefinder.smarterwolf.de/api/strecken/<slug>

GET /strecke/{slug}.gpx

Die Strecke mit Höhen und Wegpunkten als GPX-Datei. Liegt bewusst nicht unter /api/, damit die Adresse als Download-Link taugt.

curl -sO https://skatefinder.smarterwolf.de/strecke/<slug>.gpx

GET /api/termine

Skate-Termine ab einem Stichtag, aufsteigend nach Datum. Parameter: ab (Datum, Standard heute).

Wichtige Felder: datum, beginn, ende, name, art, ort, status, skaten, lat, lon, strecke_slug, treff_slug, kurztext, website. Der status abgeleitet heißt: aus dem Vorjahr oder dem üblichen Rhythmus abgeleitet, nicht bestätigt.

curl -s "https://skatefinder.smarterwolf.de/api/termine?ab=2027-01-01"

GET /api/termine.ics

Dieselben Termine als iCalendar-Feed zum Abonnieren in Kalender-Programmen. Ein einzelner Termin: /api/termine/{id}.ics.

curl -s https://skatefinder.smarterwolf.de/api/termine.ics

GET /api/orte

Ortssuche nach Namensanfang, höchstens 8 Treffer. Parameter: q (mindestens 2 Zeichen). Felder: name, lat, lon.

curl -s "https://skatefinder.smarterwolf.de/api/orte?q=Neuw"

Schwierigkeit und Datenqualität

Die Schwierigkeit ist eine Stufe von 0 bis 3: 0 leicht, 1 mittel, 2 schwer, 3 nur für Geübte. Der Belag steht getrennt als Anteil Asphalt. Alpha-Version: Die Strecken sind noch nicht vor Ort kuratiert. Alle Angaben ohne Gewähr.

Lizenz

Texte, Termine, Treffs, Bewertungen: CC BY 4.0, Namensnennung skatefinder.smarterwolf.de (WOLFSOFT).

Jede Antwort trägt einen Link-Header mit rel="license" auf die geltende(n) Lizenz(en). Mehr unter Lizenzen und Quellen.