Technische Dokumentation

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.

SchnittstelleZugangTarif
Embedsöffentlichalle Tarife
JSON-Feedöffentlich, ohne Schlüsselalle Tarife
Buchungslinksöffentlichab Pro (Online-Buchung)
REST-APIAPI-SchlüsselPremium

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>
ParameterBedeutungBeispiel
filter=1zeigt Auswahlfelder für Kursart und Standort?filter=1
typenur diese Kursart, also z. B. diesen Tanzstil?type=Salsa
locationnur dieser Standort?location=Studio%202
weeknur 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%202

Beispiel im Demo-Studio öffnen

  • Filter: type und location wie 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"]
  }
}
FeldInhalt
typeKursart aus weDance, z. B. der Tanzstil
locationName des Standorts
location_idfeste Nummer des Standorts
location_cityOrt des Standorts
timesWochentag (1 = Montag bis 7 = Sonntag), Beginn und Ende
datesalle Termine im Format JJJJ-MM-TT
pay_modesonce, monthly, membership oder pass
spots_leftfreie Plätze: 0 = ausgebucht, null = keine Begrenzung
booking_urldirekter Buchungslink, null = nicht online buchbar
filtersverfügbare Kursarten und Standorte für Ihre Auswahlfelder

Für den Anmelde-Button nutzen Sie booking_url aus dem Feed. Die Adressen sind fest und lassen sich auch von Hand setzen:

AdresseSeite
/demo/bookÜbersicht aller buchbaren Kurse
/demo/book/calendarKalender 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"
AnfrageErgebnis
GET /api/v1/coursesalle laufenden Kurse mit Teilnehmerzahl
GET /api/v1/courses/upcomingTermine der nächsten 60 Tage
GET /api/v1/customers?q=&page=1Kund:innen suchen, 100 pro Seite
GET /api/v1/customers/{id}eine Person mit ihren Kursen
POST /api/v1/customersPerson anlegen (JSON: firstname und lastname, optional email, birthday, street, zip, city, telephone, mobile)
StatusBedeutung
401Schlüssel fehlt oder ist falsch
403Kundenlimit des Tarifs erreicht
409E-Mail-Adresse ist schon vergeben
422Eingaben sind ungültig (Details im Feld errors)
429mehr als 600 Anfragen pro Stunde und IP-Adresse

Fragen zur Anbindung?

Schreiben Sie uns an support@wedance.io. Wir helfen Ihnen gern weiter.