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.
- Unter Integrationen einen API-Schlüssel erstellen und die nötigen Berechtigungen wählen.
- Den Schlüssel bei jeder Anfrage im Header
Authorization: Bearer scw_…mitschicken. - 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/campsJeder 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“.
- Einen API-Schlüssel nur mit den Leserechten erstellen, die der Assistent braucht.
- Im Assistenten einen eigenen Connector hinzufügen: Adresse
https://sommercamp.wien/api/public/mcp. - 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
400ungültige Eingabe ·401Schlüssel fehlt/ungültig ·403Berechtigung fehlt ·404nicht gefunden ·409Konflikt ·422nicht erlaubt ·429zu viele falsche Schlüssel.- Fehler kommen als
{ "error": "…" }. - Bitte frage höchstens etwa einmal pro Minute ab und nutze für Echtzeit die Webhooks.
