API für Veranstalter

Verbinde SOMMERCAMP.WIEN mit deiner eigenen Software, Website oder einem KI-Assistenten.

Schnellstart

Maschinenlesbar: OpenAPI-Beschreibung, API-Katalog, MCP Server Card.

  1. Unter Integrationen einen API-Schlüssel erstellen und die nötigen Berechtigungen wählen.
  2. Den Schlüssel bei jeder Anfrage im Header Authorization: Bearer scw_… mitschicken.
  3. Antworten kommen als JSON. Beträge sind in Cent, Datumsangaben als YYYY-MM-DD, Zeitpunkte in ISO 8601 (UTC).
curl -H "Authorization: Bearer scw_DEIN_SCHLUESSEL" \
  https://sommercamp.wien/api/public/v1/camps

Jeder Schlüssel sieht nur die Daten deines Veranstalter-Kontos. Behandle ihn wie ein Passwort und nutze ihn nur auf deinem Server – nie im Browser oder in einer App, die andere herunterladen. SV-Nummern und das Datenblatt (Gesundheitsdaten) gibt die API nicht heraus.

Camps und freie Plätze

GET/camps(camps:read)

Alle deine Camps mit Terminen (sessions), Preisen, gebuchten und freien Plätzen pro Woche.

GET/camps/{camp_id}(camps:read)

Ein Camp.

{
  "camp": {
    "id": "…", "slug": "ki", "title": "KI Camp", "status": "published",
    "url": "https://sommercamp.wien/ki/", "sold_out": false,
    "min_age": 12, "max_age": 16, "places_per_session": 10,
    "sessions": [
      { "id": "…", "label": "Woche 1", "start_date": "2027-07-05", "end_date": "2027-07-09",
        "price_cents": 39900, "booked": 4, "free_places": 6, "past": false }
    ]
  }
}

Buchungen und Teilnehmer

GET/bookings(bookings:read)

Deine Buchungen, neueste zuerst. Filter: status (confirmed, cancelled, pending_payment, pending_verification), camp_id, session_id, from/to (Buchungsdatum), updated_since (für regelmäßigen Abgleich), limit (max. 500), offset.

GET/bookings/{booking_id}(bookings:read)

Eine Buchung.

{
  "id": "…", "booking_number": "SCW-2027-0042", "status": "confirmed",
  "payment_status": "paid", "payment_method": "stripe", "source": "portal",
  "camp": { "id": "…", "title": "KI Camp", "camp_number": "SOMKI0001" },
  "session": { "id": "…", "label": "Woche 1", "start_date": "2027-07-05", "end_date": "2027-07-09" },
  "parent": { "name": "…", "email": "…", "phone": "…", "street": "…", "zip": "1030", "city": "Wien", "language": "de" },
  "children": [ { "name": "Lea", "birthdate": "2014-05-04", "notes": "…", "walk_home": false } ],
  "options": [ { "name": "Mittagessen", "price_cents": 4500 } ],
  "total_cents": 44400, "discount_cents": 0, "vat_cents": 0, "refunded_cents": 0,
  "created_at": "2026-11-19T10:00:00Z", "updated_at": "2026-11-19T10:02:00Z"
}

Termine und Plätze ändern

Bei Camps im Entwurf werden Änderungen sofort gespeichert (Antwort 200/201). Bei veröffentlichten Camps landen sie – wie im Camp-Editor – in deiner Änderungsanfrage und gehen nach der Freigabe durch das SOMMERCAMP.WIEN-Team live (Antwort 202 mit change_request_id).

POST/camps/{camp_id}/sessions(camps:write)

Neue Campwoche: { "label": "Woche 3", "start_date": "2027-07-19", "end_date": "2027-07-23", "price_cents": 39900 }

PATCH/sessions/{session_id}(camps:write)

Woche ändern, beliebige Felder: label, start_date, end_date, price_cents.

DELETE/sessions/{session_id}(camps:write)

Woche entfernen – nur ohne Buchungen (sonst 409).

PATCH/camps/{camp_id}(camps:write)

{ "sold_out": true } gilt sofort, { "places_per_session": 12 } bei veröffentlichten Camps nach Freigabe.

Webhooks

Unter Integrationen eine https-Adresse deines Systems eintragen. Bei booking.confirmed (neue bestätigte Buchung) und booking.cancelled (Stornierung) senden wir einen POST mit der Buchung im selben Format wie oben. Antworte mit einem 2xx-Status innerhalb von 10 Sekunden; sonst versuchen wir es nach 1, 5, 15 und 30 Minuten und dann in wachsenden Abständen bis zu 24 Stunden erneut. Ein Ereignis kann daher mehr als einmal ankommen – erkenne Wiederholungen an der id.

POST https://dein-system.at/webhooks/sommercamp
X-SCW-Event: booking.confirmed
X-SCW-Delivery: <id des Ereignisses>
X-SCW-Signature: t=1795000000,v1=<HMAC-SHA256 in hex>

{ "id": "…", "type": "booking.confirmed", "created_at": "…", "api_version": 1,
  "data": { "booking": { … } } }

Signatur prüfen: HMAC-SHA256 über <t>.<roher Body> mit deinem Geheimschlüssel berechnen und mit v1 vergleichen; Nachrichten mit einem t älter als 5 Minuten verwerfen.

// Node.js
import crypto from "node:crypto";
function verify(rawBody, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

KI-Assistenten (MCP)

Über den MCP-Connector fragen KI-Assistenten wie Claude deine Daten direkt ab, z. B. „Wie viele Plätze sind im KI Camp in Woche 2 noch frei?“ oder „Liste alle Kinder mit Allergien für nächste Woche“.

  1. Einen API-Schlüssel nur mit den Leserechten erstellen, die der Assistent braucht.
  2. Im Assistenten einen eigenen Connector hinzufügen: Adresse https://sommercamp.wien/api/public/mcp.
  3. Als Authentifizierung den API-Schlüssel als Bearer-Token eintragen.

Werkzeuge: list_camps, get_camp, list_bookings, get_booking und – mit Schreibrecht – add_session, update_session, delete_session, update_camp. Personenbezogene Daten der Familien gelangen damit zum Anbieter des Assistenten: Prüfe, ob das mit deiner Datenschutzerklärung und deinem Auftragsverarbeitungsvertrag vereinbar ist.

Fehler und Grenzen

  • 400 ungültige Eingabe · 401 Schlüssel fehlt/ungültig · 403 Berechtigung fehlt · 404 nicht gefunden · 409 Konflikt · 422 nicht erlaubt · 429 zu viele falsche Schlüssel.
  • Fehler kommen als { "error": "…" }.
  • Bitte frage höchstens etwa einmal pro Minute ab und nutze für Echtzeit die Webhooks.