API-Documentatie

Integreer jouw levensstijl bedrijf en evenementen met het Swingular-platform

Authenticatie

Beveiligde API-toegang met OAuth 2.0 en API-sleutels

Endpoints

Uitgebreide REST API voor evenementen, profielen en meer

Documentatie

Gedetailleerde gidsen, voorbeelden en SDK-referenties

API-Overzicht

Aan de Slag

1. Registreer als Partner

Voordat je toegang kunt krijgen tot de API, moet je je registreren als Swingular-partner. Dit is gratis en geeft je toegang tot onze basis API-tier.

2. Genereer API-Sleutels

Eenmaal geregistreerd kun je API-sleutels genereren vanuit je partner-dashboard. Deze sleutels worden gebruikt om jouw API-verzoeken te authenticeren.

3. Doe API-Verzoeken

Gebruik jouw API-sleutels om verzoeken te doen aan onze endpoints. Alle verzoeken dienen via HTTPS te worden gedaan en jouw API-sleutel in de header te bevatten.

Authenticatie

API-Sleutel Authenticatie

Voeg jouw API-sleutel toe in de Authorization-header van jouw verzoeken:

Authorization: Bearer YOUR_API_KEY

OAuth 2.0

Voor applicaties die toegang nodig hebben tot gebruikersgegevens, gebruik 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

Limieten

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-Endpoints

/events

Maak, lees, update en verwijder evenementen. Filter op datum, locatie en type.

GET/events

Lijst alle evenementen met paginering en filtering

POST/events

Maak een nieuw evenement

GET/events/{id}

Haal een specifiek evenement op via ID

PUT/events/{id}

Update een bestaand evenement

/business

Beheer jouw bedrijfsprofiel, openingstijden, voorzieningen en foto's.

GET/business

Haal jouw bedrijfsprofiel op

PUT/business

Update jouw bedrijfsprofiel

POST/business/photos

Upload bedrijfsfoto's

GET/business/reviews

Haal beoordelingen op voor jouw bedrijf

/analytics

Toegang tot analysegegevens voor jouw bedrijf en evenementen.

GET/analytics/events

Haal analyses op voor jouw evenementen

GET/analytics/business

Haal analyses op voor jouw bedrijfsprofiel

GET/analytics/demographics

Haal demografische gegevens op voor jouw bezoekers

GET/analytics/reports

Genereer aangepaste rapporten

Klaar om te Integreren?

Begin vandaag met onze API en verbind jouw levensstijl bedrijf met miljoenen potentiële klanten.

Frequently Asked Questions

Welke programmeertalen worden ondersteund?

Onze REST API werkt met elke programmeertaal die HTTP-verzoeken kan maken. We bieden SDK's voor JavaScript, Python, PHP en .NET, met meer talen binnenkort beschikbaar.

Is er een sandbox-omgeving voor testen?

Ja, we bieden een volledige sandbox-omgeving met testgegevens die onze productie-API weerspiegelt. Alle partners krijgen toegang tot de sandbox tijdens het integratieproces.

Wat zijn de limieten voor de API?

Basispartners krijgen 1.000 verzoeken per dag en 60 per minuut. Premiumpartners krijgen 10.000 verzoeken per dag en 300 per minuut. Enterprise-plannen bieden aangepaste limieten.

Bieden jullie webhook-meldingen?

Ja, we ondersteunen webhooks voor real-time meldingen over gebeurtenissen zoals nieuwe RSVP's, evenementenwijzigingen en bedrijfsprofielwijzigingen. Webhook-endpoints zijn configureerbaar in jouw partner-dashboard.

Hoe krijg ik ondersteuning tijdens de integratie?

Alle partners krijgen toegang tot ons ontwikkelaarsondersteuningsteam. Premiumpartners ontvangen prioriteitsondersteuning met dedicated integratie-specialisten en snellere responstijden.