weDance in Ihre Website einbinden
Fertige Embeds, ein öffentlicher JSON-Feed, direkte Buchungslinks und eine REST-API. Funktioniert mit WordPress, Elementor und jedem anderen System.
Erste Schritte
Alle Adressen beginnen mit der Kennung der Tanzschule, also dem Teil hinter app.wedance.io/. In den Beispielen steht dafür demo, unser öffentliches Demo-Studio. Sie können alle Adressen dort direkt ausprobieren.
Embeds und JSON-Feed schalten Sie unter Einstellungen → Website & API mit „Kursplan öffentlich freigeben“ frei.
| Schnittstelle | Zugang | Tarif |
|---|---|---|
Embeds | öffentlich | alle Tarife |
JSON-Feed | öffentlich, ohne Schlüssel | alle Tarife |
Buchungslinks | öffentlich | ab Pro (Online-Buchung) |
REST-API | API-Schlüssel | Premium |
Embeds
Kursliste und Wochenkalender binden Sie per iFrame ein. Beide zeigen freie Plätze, und ein Klick führt direkt zur Buchung.
<!-- Kursliste mit Auswahl nach Kursart und Standort -->
<iframe src="https://app.wedance.io/demo/embed/courses?filter=1"
title="Kursplan" width="100%" height="800" loading="lazy" style="border:0"></iframe>
<!-- Wochenkalender, fest auf einen Standort eingestellt -->
<iframe src="https://app.wedance.io/demo/embed/calendar?location=Studio%202"
title="Kurskalender" width="100%" height="900" loading="lazy" style="border:0"></iframe>| Parameter | Bedeutung | Beispiel |
|---|---|---|
filter=1 | zeigt Auswahlfelder für Kursart und Standort | ?filter=1 |
type | nur diese Kursart, also z. B. diesen Tanzstil | ?type=Salsa |
location | nur dieser Standort | ?location=Studio%202 |
week | nur Kalender: diese Kalenderwoche | ?week=2026-W48 |
Mehrere Werte geben Sie so an: ?type[]=Salsa&type[]=Discofox. Groß- und Kleinschreibung spielt keine Rolle.
JSON-Feed
Der Feed liefert alle öffentlichen Kurse und Events, damit Sie Filter und Darstellung selbst bauen können. Er enthält keine Daten von Teilnehmenden.
GET https://app.wedance.io/demo/public/courses.json?type=Salsa&location=Studio%202Beispiel im Demo-Studio öffnen
- Filter:
typeundlocationwie bei den Embeds. Ein Filter nach Kursart blendet Events aus, weil sie keine Kursart haben. - Zwischenspeichern: Die Antwort darf 5 Minuten gespeichert werden. Die freien Plätze prüft weDance bei der Buchung erneut.
- Limit: 120 Anfragen pro Minute und IP-Adresse für Feed und Embeds zusammen, danach Status 429.
- CORS: Der Abruf ist von jeder Domain aus erlaubt.
{
"school": "Tanzschule Demo",
"courses": [
{
"id": 5,
"name": "Salsa Grundkurs",
"type": "Salsa",
"description": "Für Einsteiger ohne Vorkenntnisse.",
"weekday": "Mittwoch",
"time": "19:00",
"when": "Mittwochs, 19:00 Uhr",
"times": [{ "weekday": 3, "start": "19:00", "end": "20:30" }],
"duration_minutes": 90,
"dates": ["2027-01-13", "2027-01-20"],
"location": "Studio 2",
"location_id": 2,
"location_city": "Berlin",
"teacher": "Sabine Tanzmann",
"pay_modes": ["once"],
"price": 149,
"price_monthly": null,
"price_type": "Einmalig",
"price_label": "149,00 €",
"spots_left": 7,
"booking_url": "https://app.wedance.io/demo/book/course/5"
}
],
"events": [],
"filters": {
"types": ["Discofox", "Salsa"],
"locations": ["Großer Saal", "Studio 2"]
}
}| Feld | Inhalt |
|---|---|
type | Kursart aus weDance, z. B. der Tanzstil |
location | Name des Standorts |
location_id | feste Nummer des Standorts |
location_city | Ort des Standorts |
times | Wochentag (1 = Montag bis 7 = Sonntag), Beginn und Ende |
dates | alle Termine im Format JJJJ-MM-TT |
pay_modes | once, monthly, membership oder pass |
spots_left | freie Plätze: 0 = ausgebucht, null = keine Begrenzung |
booking_url | direkter Buchungslink, null = nicht online buchbar |
filters | verfügbare Kursarten und Standorte für Ihre Auswahlfelder |
Buchungslinks
Für den Anmelde-Button nutzen Sie booking_url aus dem Feed. Die Adressen sind fest und lassen sich auch von Hand setzen:
| Adresse | Seite |
|---|---|
/demo/book | Übersicht aller buchbaren Kurse |
/demo/book/calendar | Kalender auf der Buchungsseite |
/demo/book/course/{id} | Buchung eines Kurses |
/demo/book/event/{id} | Buchung eines Events |
Die Buchungsseite öffnet sich aus Sicherheitsgründen immer als eigene Seite und lässt sich nicht per iFrame einbetten. Sie erscheint in den Farben und mit dem Logo der Tanzschule.
WordPress-Beispiel
Dieser Shortcode lädt den Feed auf dem Server, speichert ihn 5 Minuten und zeigt die Kurse mit Filter und Anmelde-Button. Fügen Sie ihn in ein eigenes Plugin oder Child-Theme ein und setzen Sie [wedance_kurse schule="demo"] in das Shortcode-Widget von Elementor.
add_shortcode('wedance_kurse', function ($atts) {
$atts = shortcode_atts(['schule' => 'demo'], $atts);
$cache = 'wedance_kurse_' . md5($atts['schule']);
$data = get_transient($cache);
if ($data === false) {
$url = 'https://app.wedance.io/' . rawurlencode($atts['schule']) . '/public/courses.json';
$response = wp_remote_get($url, ['timeout' => 10]);
if (is_wp_error($response) || wp_remote_retrieve_response_code($response) !== 200) {
return '<p>Der Kursplan ist gerade nicht erreichbar.</p>';
}
$data = json_decode(wp_remote_retrieve_body($response), true);
set_transient($cache, $data, 5 * MINUTE_IN_SECONDS);
}
$stil = sanitize_text_field(wp_unslash($_GET['stil'] ?? ''));
$standort = sanitize_text_field(wp_unslash($_GET['standort'] ?? ''));
$auswahl = function ($name, $leer, $werte, $aktiv) {
$html = '<select name="' . esc_attr($name) . '" onchange="this.form.submit()">';
$html .= '<option value="">' . esc_html($leer) . '</option>';
foreach ($werte as $wert) {
$html .= '<option value="' . esc_attr($wert) . '"' . selected($aktiv, $wert, false) . '>' . esc_html($wert) . '</option>';
}
return $html . '</select>';
};
$html = '<form method="get" class="wedance-filter">'
. $auswahl('stil', 'Alle Tanzstile', $data['filters']['types'], $stil)
. $auswahl('standort', 'Alle Standorte', $data['filters']['locations'], $standort)
. '</form><div class="wedance-kurse">';
foreach ($data['courses'] as $kurs) {
if (($stil !== '' && $kurs['type'] !== $stil) || ($standort !== '' && $kurs['location'] !== $standort)) {
continue;
}
$frei = $kurs['spots_left'];
$html .= '<article><h3>' . esc_html($kurs['name']) . '</h3>'
. '<p>' . esc_html($kurs['when'] . ' · ' . $kurs['location']) . '</p>'
. '<p>' . esc_html($frei === null ? 'Plätze frei' : ($frei === 0 ? 'Ausgebucht' : $frei . ' Plätze frei')) . '</p>';
if ($kurs['booking_url'] !== null && $frei !== 0) {
$html .= '<a class="button" href="' . esc_url($kurs['booking_url']) . '">Jetzt anmelden</a>';
}
$html .= '</article>';
}
return $html . '</div>';
});Möchten Sie die Kurse als eigene Beiträge mit ACF-Feldern pflegen, rufen Sie den Feed per WP-Cron ab und legen je Kurs einen Beitrag an. Als eindeutigen Schlüssel nutzen Sie dabei das Feld id.
REST-API
Die REST-API ist für Anbindungen mit Kundendaten gedacht. Für einen Kursplan auf der Website reicht der JSON-Feed. Den Schlüssel erzeugen Sie unter Einstellungen → Website & API. Rufen Sie die API nur vom Server aus auf, damit der Schlüssel nicht im Browser landet.
curl https://app.wedance.io/demo/api/v1/courses \
-H "Authorization: Bearer IHR_API_SCHLUESSEL"| Anfrage | Ergebnis |
|---|---|
GET /api/v1/courses | alle laufenden Kurse mit Teilnehmerzahl |
GET /api/v1/courses/upcoming | Termine der nächsten 60 Tage |
GET /api/v1/customers?q=&page=1 | Kund:innen suchen, 100 pro Seite |
GET /api/v1/customers/{id} | eine Person mit ihren Kursen |
POST /api/v1/customers | Person anlegen (JSON: firstname und lastname, optional email, birthday, street, zip, city, telephone, mobile) |
| Status | Bedeutung |
|---|---|
401 | Schlüssel fehlt oder ist falsch |
403 | Kundenlimit des Tarifs erreicht |
409 | E-Mail-Adresse ist schon vergeben |
422 | Eingaben sind ungültig (Details im Feld errors) |
429 | mehr als 600 Anfragen pro Stunde und IP-Adresse |
Fragen zur Anbindung?
Schreiben Sie uns an support@wedance.io. Wir helfen Ihnen gern weiter.