API-Dokumentation

Integriere dein Lifestyle-Unternehmen und deine Events in die Swingular-Plattform

Authentifizierung

Sicherer API-Zugang mit OAuth 2.0 und API-Schlüsseln

Endpunkte

Umfassende REST-API für Events, Profile und mehr

Dokumentation

Detaillierte Anleitungen, Beispiele und SDK-Referenzen

API-Übersicht

Erste Schritte

1. Als Partner registrieren

Bevor du auf die API zugreifen kannst, musst du dich als Swingular-Partner registrieren. Dies ist kostenlos und gibt dir Zugang zu unserer grundlegenden API-Stufe.

2. API-Schlüssel generieren

Nach der Registrierung kannst du API-Schlüssel über dein Partner-Dashboard generieren. Diese Schlüssel werden zur Authentifizierung deiner API-Anfragen verwendet.

3. API-Anfragen stellen

Verwende deine API-Schlüssel, um Anfragen an unsere Endpunkte zu stellen. Alle Anfragen sollten über HTTPS gestellt werden und deinen API-Schlüssel im Header enthalten.

Authentifizierung

API-Schlüssel-Authentifizierung

Gib deinen API-Schlüssel im Authorization-Header deiner Anfragen an:

Authorization: Bearer YOUR_API_KEY

OAuth 2.0

Für Anwendungen, die Zugang zu Benutzerdaten benötigen, verwende OAuth 2.0:

// Step 1: Redirect to authorization URL
https://api.swingular.com/oauth/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=YOUR_REDIRECT_URI&
  response_type=code&
  scope=events.read,events.write

Anfragen-Limits

Basisplan

• 1,000 requests per day
• 60 requests per minute
• Cached responses for high-volume endpoints

Premiumplan

• 10,000 requests per day
• 300 requests per minute
• Priority access during high traffic
• Dedicated support for API integration

API-Endpunkte

/events

Erstelle, lies, aktualisiere und lösche Events. Filtere nach Datum, Standort und Typ.

GET/events

Alle Events mit Paginierung und Filterung auflisten

POST/events

Ein neues Event erstellen

GET/events/{id}

Ein bestimmtes Event nach ID abrufen

PUT/events/{id}

Ein bestehendes Event aktualisieren

/business

Verwalte dein Unternehmensprofil, Öffnungszeiten, Ausstattung und Fotos.

GET/business

Dein Unternehmensprofil abrufen

PUT/business

Dein Unternehmensprofil aktualisieren

POST/business/photos

Unternehmensfotos hochladen

GET/business/reviews

Bewertungen für dein Unternehmen abrufen

/analytics

Zugang zu Analysedaten für dein Unternehmen und deine Events.

GET/analytics/events

Analysen für deine Events abrufen

GET/analytics/business

Analysen für dein Unternehmensprofil abrufen

GET/analytics/demographics

Demografiedaten für deine Besucher abrufen

GET/analytics/reports

Benutzerdefinierte Berichte generieren

Bereit zur Integration?

Starte noch heute mit unserer API und verbinde dein Lifestyle-Unternehmen mit Millionen von potenziellen Kunden.

Häufig gestellte Fragen

Welche Programmiersprachen werden unterstützt?

Unsere REST-API funktioniert mit jeder Programmiersprache, die HTTP-Anfragen stellen kann. Wir stellen SDKs für JavaScript, Python, PHP und .NET bereit, mit weiteren Sprachen in Kürze.

Gibt es eine Sandbox-Umgebung zum Testen?

Ja, wir stellen eine vollständige Sandbox-Umgebung mit Testdaten bereit, die unsere Produktions-API spiegelt. Alle Partner erhalten während des Integrationsprozesses Zugang zur Sandbox.

Was sind die Anfragen-Limits für die API?

Basispartner erhalten 1.000 Anfragen pro Tag und 60 pro Minute. Premium-Partner erhalten 10.000 Anfragen pro Tag und 300 pro Minute. Unternehmenspläne bieten benutzerdefinierte Limits.

Bietet ihr Webhook-Benachrichtigungen an?

Ja, wir unterstützen Webhooks für Echtzeit-Benachrichtigungen bei Events wie neuen RSVPs, Event-Updates und Änderungen am Unternehmensprofil. Webhook-Endpunkte sind in deinem Partner-Dashboard konfigurierbar.

Wie erhalte ich Support während der Integration?

Alle Partner erhalten Zugang zu unserem Entwickler-Support-Team. Premium-Partner erhalten Priority-Support mit dedizierten Integrationsspezialisten und schnelleren Antwortzeiten.