Documentazione API

Integra la tua attività lifestyle e i tuoi eventi con la piattaforma Swingular

Autenticazione

Accesso API sicuro con OAuth 2.0 e chiavi API

Endpoint

API REST completa per eventi, profili e altro

Documentazione

Guide dettagliate, esempi e riferimenti SDK

Panoramica API

Per iniziare

1. Registrati come partner

Prima di poter accedere all'API, devi registrarti come partner Swingular. È gratuito e ti dà accesso al nostro livello API base.

2. Genera le chiavi API

Una volta registrato, puoi generare le chiavi API dalla tua dashboard partner. Queste chiavi vengono utilizzate per autenticare le tue richieste API.

3. Effettua richieste API

Usa le tue chiavi API per effettuare richieste ai nostri endpoint. Tutte le richieste devono essere effettuate tramite HTTPS e includere la tua chiave API nell'header.

Autenticazione

Autenticazione con chiave API

Includi la tua chiave API nell'header Authorization delle tue richieste:

Authorization: Bearer YOUR_API_KEY

OAuth 2.0

Per le applicazioni che necessitano di accedere ai dati degli utenti, usa 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

Limiti di velocità

Piano base

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

Piano premium

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

Endpoint API

/events

Crea, leggi, aggiorna ed elimina eventi. Filtra per data, luogo e tipo.

GET/events

Elenca tutti gli eventi con paginazione e filtraggio

POST/events

Crea un nuovo evento

GET/events/{id}

Ottieni un evento specifico per ID

PUT/events/{id}

Aggiorna un evento esistente

/business

Gestisci il tuo profilo aziendale, orari, servizi e foto.

GET/business

Ottieni il tuo profilo aziendale

PUT/business

Aggiorna il tuo profilo aziendale

POST/business/photos

Carica foto aziendali

GET/business/reviews

Ottieni le recensioni per la tua attività

/analytics

Accedi ai dati analitici per la tua attività e i tuoi eventi.

GET/analytics/events

Ottieni analisi per i tuoi eventi

GET/analytics/business

Ottieni analisi per il tuo profilo aziendale

GET/analytics/demographics

Ottieni dati demografici sui tuoi visitatori

GET/analytics/reports

Genera report personalizzati

Pronto a integrarti?

Inizia oggi con la nostra API e connetti la tua attività lifestyle con milioni di potenziali clienti.

Frequently Asked Questions

Quali linguaggi di programmazione sono supportati?

La nostra API REST funziona con qualsiasi linguaggio di programmazione in grado di effettuare richieste HTTP. Forniamo SDK per JavaScript, Python, PHP e .NET, con altri linguaggi in arrivo.

Esiste un ambiente sandbox per i test?

Sì, forniamo un ambiente sandbox completo con dati di test che rispecchia la nostra API di produzione. Tutti i partner hanno accesso al sandbox durante il processo di integrazione.

Quali sono i limiti di velocità per l'API?

I partner base ottengono 1.000 richieste al giorno e 60 al minuto. I partner premium ottengono 10.000 richieste al giorno e 300 al minuto. I piani enterprise offrono limiti personalizzati.

Fornite notifiche webhook?

Sì, supportiamo i webhook per notifiche in tempo reale su eventi come nuovi RSVP, aggiornamenti degli eventi e modifiche al profilo aziendale. Gli endpoint webhook sono configurabili nella tua dashboard partner.

Come posso ottenere supporto durante l'integrazione?

Tutti i partner hanno accesso al nostro team di supporto per sviluppatori. I partner premium ricevono supporto prioritario con specialisti di integrazione dedicati e tempi di risposta più rapidi.