Stato del workspace e telemetria live
Ogni account Passinstance opera all'interno di un workspace tenant rigorosamente partizionato. Tutte le risorse create in un workspace — inclusi modelli visuali, certificati crittografici di firma, proprietà personalizzate, record dei pass dei clienti, segreti API e storico delle scansioni al punto vendita — sono limitate al proprio ID workspace (customerId) e risultano completamente isolate dalle altre organizzazioni.

Architettura multi-tenant e gerarchia dei workspace
Passinstance implementa una gerarchia organizzativa su due livelli che separa la governance della fatturazione dell'account dalla gestione quotidiana dei pass:
Gestire workspace fratelli tramite l'API Organization
I team che gestiscono più brand, account clienti o ambienti sandbox possono interagire con Organizations API:
| Percorso endpoint | Metodo | Auth | Funzionalità | |
|---|---|---|---|---|
/api/v1/organizations/current | GET | Bearer | Restituisce l'organizzazione attiva, i ruoli dei membri e l'elenco dei workspace fratelli accessibili. | |
/api/v1/organizations/current/billing-summary | GET | Bearer | Riepilogo dei limiti del piano e dei conteggi cumulativi di pass attivi su tutti i workspace. | |
/api/v1/organizations/current/workspaces | POST | Bearer | Crea un nuovo workspace fratello (`kind: "production" \ | "sandbox"`). |
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Cambia il contesto tenant attivo e ruota i cookie di sessione autenticati. |
Tassonomia delle metriche principali di telemetria
Per monitorare con precisione il programma pass, Passinstance distingue tra la creazione del record lato server e l'installazione fisica nel Wallet:
Pass creato (POST /api/v1/passes) =================> unclaimedPasses (Non installati)
|
| Il cliente aggiunge al Wallet
v
Dispositivo registrato (POST /v1/devices/...) =====> installedDevices (Installati)
|
| Il cliente rimuove dal Wallet
v
Dispositivo annullato (DELETE /v1/devices/...) ====> inactivePasses / inactiveDeviceRegistrations
Definizioni da metric-definitions.ts
-
totalPasses(Total Passes Issued): Conteggio cumulativo dei record pass attivi generati nel workspace che non risultano eliminati al momento dello snapshot. -
activePasses(Active Passes): Istanze di pass attive che dispongono attualmente di almeno una registrazione dispositivo raggiungibile (esclusi pass scaduti e annullati). -
installedDevices(Active Device Registrations): Registrazioni di pass salvati e raggiungibili su Apple APNs e Google Wallet. Se un pass è salvato su due dispositivi, conta come due registrazioni attive e consuma capacità del piano di conseguenza. -
unclaimedPasses(Unclaimed Passes): Istanze di pass attive emesse in Passinstance che non sono mai state salvate in un Wallet. -
inactivePasses(Removed Passes): Istanze di pass attive salvate in precedenza in un Wallet, ma che non hanno più alcuna registrazione dispositivo raggiungibile (inclusiDELETE /v1/devices/...Apple e callbackdelGoogle verso/api/v1/wallet/callback). -
voidedPasses(Voided Passes) edexpiredPasses(Expired Passes): Istanze di pass revocate lato server oppure oltreexpirationDate.
Impostazioni workspace e configurazione regionale
Ogni workspace viene configurato in modo indipendente sotto Impostazioni -> Workspace (/settings/workspace/*):
-
Impostazioni generali e regionali (
PUT /api/v1/customer/:customerId/regional-settings): Configura il fuso orario predefinito (resolveCustomerTimeZone), il codice valuta ISO 4217 predefinito e la lingua locale. -
Quote di utilizzo (
GET /api/v1/customer/:customerId/usage-summary): Riporta in tempo reale i pass totali, i pass attivi rispetto amaxActivePassese il conteggio dei modelli. -
Vanity domain Whitelabel (
/api/v1/white-labeling/vanity-urls): Collega domini personalizzati (domain surface type:PASS_DOWNLOAD,PASS_FLOW,BACKEND_UI, ecc.) con provisioning SSL automatico per tutti gli smart link e le pagine di download.
Importante: I workspace sandbox forniscono un ambiente isolato per testare revisioni dei modelli, webhook API e configurazioni scanner senza consumare capacità di pass attivi dal piano di produzione.
