API-Dokumentation

Integrieren Sie Ihr Lifestyle-Unternehmen und Ihre 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 Sie auf die API zugreifen können, müssen Sie sich als Swingular-Partner registrieren. Dies ist kostenlos und gibt Ihnen Zugang zu unserer grundlegenden API-Stufe.

2. API-Schlüssel generieren

Nach der Registrierung können Sie API-Schlüssel über Ihr Partner-Dashboard generieren. Diese Schlüssel werden zur Authentifizierung Ihrer API-Anfragen verwendet.

3. API-Anfragen stellen

Verwenden Sie Ihre API-Schlüssel, um Anfragen an unsere Endpunkte zu stellen. Alle Anfragen sollten über HTTPS gestellt werden und Ihren API-Schlüssel im Header enthalten.

Authentifizierung

API-Schlüssel-Authentifizierung

Geben Sie Ihren API-Schlüssel im Authorization-Header Ihrer Anfragen an:

Authorization: Bearer YOUR_API_KEY

OAuth 2.0

Für Anwendungen, die Zugang zu Benutzerdaten benötigen, verwenden Sie 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

Erstellen, lesen, aktualisieren und löschen Sie Events. Filtern Sie 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

Verwalten Sie Ihr Unternehmensprofil, Öffnungszeiten, Ausstattung und Fotos.

GET/business

Ihr Unternehmensprofil abrufen

PUT/business

Ihr Unternehmensprofil aktualisieren

POST/business/photos

Unternehmensfotos hochladen

GET/business/reviews

Bewertungen für Ihr Unternehmen abrufen

/analytics

Zugang zu Analysedaten für Ihr Unternehmen und Ihre Events.

GET/analytics/events

Analysen für Ihre Events abrufen

GET/analytics/business

Analysen für Ihr Unternehmensprofil abrufen

GET/analytics/demographics

Demografiedaten für Ihre Besucher abrufen

GET/analytics/reports

Benutzerdefinierte Berichte generieren

Bereit zur Integration?

Beginnen Sie noch heute mit unserer API und verbinden Sie Ihr Lifestyle-Unternehmen mit Millionen von potenziellen Kunden.

Frequently Asked Questions

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.

Bieten Sie 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 Ihrem 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.