WelcomePassCloud
Home / SmartCloud API

API pubblica WelcomePassCloud

L'API pubblica consente al tuo staff tecnico di consultare lo stato dei moduli attivi, esportare i dati statistici prodotti dalle estensioni SmartCloud e integrare i risultati in dashboard aziendali interne.

Base URL

https://api.welcomepasscloud.org/v1

Autenticazione

Tutte le chiamate richiedono un token JWT firmato generato dalla tua area cliente WelcomePassCloud (sezione «SmartCloud API»). Il token è passato nell'header Authorization: Bearer <token>. Ogni token è associato a un ruolo con permessi granulari (sola lettura, lettura + esportazione, amministrazione).

Rate limiting

60 richieste al minuto per token, 5.000 richieste al giorno per account, 100 connessioni concorrenti massime. Limiti superiori disponibili nel piano «Gruppo».

Endpoint principali

  • GET /modules — Elenco dei moduli attivi sull'account.
  • GET /modules/{id}/status — Stato di connessione API e ultima sincronizzazione.
  • GET /invoices — Elenco delle fatture emesse.
  • GET /smartcloud/kpi — KPI aggregati dell'ambiente Welcome SmartCloud collegato.
  • POST /showcloud/reports/export — Esportazione PDF di un report ShowCloud predefinito.
  • GET /passgo/alloggiati/status — Stato delle comunicazioni Alloggiati Web trasmesse tramite Passgo.

Documentazione OpenAPI

Lo schema OpenAPI 3.1 è disponibile su richiesta all'indirizzo api@welcomepasscloud.org. Include esempi di chiamata in italiano e collezione Postman precompilata.

Rilascio versioni

Politica di versionamento semantico. Ogni versione major è supportata per 24 mesi dalla data di rilascio. Il changelog dell'API è pubblicato su /changelog.