API-Überblick

Die öffentliche Sway-API lässt eine Crew (eine Agentur, ein Veranstalterkollektiv, ein Venue-Team) ihre eigene Website mit ihren Sway-Daten betreiben. Deine Site bleibt unabhängig und spricht nur über die API mit Sway:

• Zeig dein Roster, deine Veranstaltungen, Lineups und Timetables, Veranstaltungsorte, News, Partner, Galerien und Presskits.
• Verkauf Tickets: Öffne einen Sway-Checkout von deiner Site aus, prüf zuerst einen Gutschein oder einen Zugangscode, verfolg die Bestellung.
• Verkauf Merch aus den Shops deiner Seiten: den Katalog, einen von Sway berechneten Warenkorb, einen Stripe-Checkout auf dem Konto der Seite.
• Sammle: Booking-Anfragen, Newsletter-Anmeldungen, Antworten auf deine Formulare.
• Betreib dein Ambassador-Programm auf deinen eigenen Seiten: Anmeldung, Login per E-Mail-Link, Mitgliederbereich, Ranking, Belohnungen.
• Erfahr von Änderungen, sobald sie passieren, mit Webhooks, statt alle paar Minuten nachzufragen.
• Frag einen KI-Assistenten nach deinen Daten über den MCP-Server.

Basis-URL

https://www.sway.events/api/v1

Jeder Endpunkt ist unter /v1 versioniert. Antworten sind JSON mit Schlüsseln in snake_case, außer bei den Kalender-Feeds (text/calendar) und den Exporten (NDJSON). GET /v1/openapi.json beschreibt jeden Endpunkt in OpenAPI 3.1, und GET /v1/changelog listet, was sich wann geändert hat.

Wer Zugang hat

Die API gehört zu den Plänen Studio und Roster. Schlüssel legt jemand mit der Berechtigung API verwalten auf der Crew in Crew-Admin → API an.

Jeder Schlüssel gehört genau einer Crew: Nur der Schlüssel entscheidet, wessen Daten du siehst, nie ein Anfrageparameter. Läuft das Abo der Crew aus, funktionieren ihre Schlüssel erst wieder, wenn es wieder aktiv ist.

Was dein Schlüssel sehen kann

Alles, was die API liefert, ist entweder verwaltet oder öffentlich:

Beispiel: der Gastkünstler. Die Veranstaltung deines Veranstalters hat einen Künstler im Lineup, der nicht zu deiner Crew gehört. Er erscheint im Lineup der Veranstaltung mit nur öffentlichen Feldern (Name, Bild, Genres) und "managed": false. Direkt abgerufen antwortet GET /v1/artists/{id} mit 404.

Alles außerhalb der Seiten deiner Crew antwortet mit 404, nie mit 403: So verrät die API nichts über das, was du nicht erreichen kannst.

Schnellstart

Prüf deinen Schlüssel und was er darf:

curl https://www.sway.events/api/v1/me \
  -H "Authorization: Bearer sway_sk_YOUR_KEY"

{
  "key": {
    "id": "3f9a1c02-7b45-4c8e-9d21-0a1b2c3d4e5f",
    "type": "secret",
    "scopes": ["read:profile", "read:artists", "read:promoters", "read:events", "read:venues", "read:content"],
    "rate_limit": { "per_minute": 120, "per_day": 20000 },
    "limits": {
      "requests_per_minute": 2400,
      "crew_work_per_minute": 600,
      "crew_work_per_day": 120000,
      "bytes_per_day": 5368709120
    },
    "websites": []
  },
  "crew": { "id": "a2628d53-4f21-4c1e-9b7d-1a2b3c4d5e6f", "name": "Insomnia", "slug": "insomnia" }
}

List dann deine kommenden Veranstaltungen auf:

curl "https://www.sway.events/api/v1/events?limit=10" \
  -H "Authorization: Bearer sway_sk_YOUR_KEY"

Eine einzelne Ressource kommt als das Objekt selbst zurück; eine Liste kommt verpackt in { "data": [...], "pagination": {...} }.

Mehr erfahren