Workspace-gezondheid & live telemetrie
Elk Passinstance-account werkt binnen een strikt gescheiden tenant-workspace. Alle assets die binnen een workspace worden aangemaakt — waaronder visuele sjablonen, cryptografische ondertekeningscertificaten, aangepaste eigenschappen, pasrecords van klanten, API-geheimen en scangeschiedenis van de kassa — zijn gekoppeld aan uw workspace-ID (customerId) en volledig geïsoleerd van andere organisaties.

Multi-tenant architectuur & workspace-hiërarchie
Passinstance hanteert een tweetrapshiërarchie voor organisaties, waarmee accountfacturatie wordt gescheiden van dagelijks pasbeheer:
Zuster-workspaces beheren via de Organization API
Teams die meerdere merken, klantaccounts of sandbox-omgevingen beheren, kunnen de Organizations API gebruiken:
| Endpointpad | Methode | Auth | Functionaliteit | |
|---|---|---|---|---|
/api/v1/organizations/current | GET | Bearer | Retourneert de actieve organisatie, ledenrollen en een lijst van toegankelijke zuster-workspaces. | |
/api/v1/organizations/current/billing-summary | GET | Bearer | Overzicht van abonnementslimieten en cumulatieve aantallen actieve passen over alle workspaces. | |
/api/v1/organizations/current/workspaces | POST | Bearer | Maakt een nieuwe zuster-workspace aan (`kind: "production" \ | "sandbox"`). |
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Schakelt naar een andere actieve tenantcontext en roteert authenticatiesessiecookies. |
Taxonomie van kerntelemetriestatistieken
Om uw pasprogramma nauwkeurig te volgen, maakt Passinstance onderscheid tussen serverzijdige recordaanmaak en fysieke wallet-installatie:
Pas aangemaakt (POST /api/v1/passes) ===============> unclaimedPasses (Niet geïnstalleerd)
|
| Klant voegt toe aan Wallet
v
Apparaat geregistreerd (POST /v1/devices/...) ======> installedDevices (Geïnstalleerd)
|
| Klant verwijdert uit Wallet
v
Apparaat afgemeld (DELETE /v1/devices/...) =========> inactivePasses / inactiveDeviceRegistrations
Definities uit metric-definitions.ts
-
totalPasses(Totaal uitgegeven passen): Cumulatief aantal live pasrecords dat in uw workspace is gegenereerd en op het moment van de meting niet is verwijderd. -
activePasses(Actieve passen): Live pasinstanties die momenteel ten minste één bereikbare apparaatregistratie hebben (exclusief verlopen en ongeldig verklaarde passen). -
installedDevices(Actieve apparaatregistraties): Bereikbare opgeslagen pasregistraties via Apple APNs en Google Wallet. Als één pas op twee apparaten is opgeslagen, telt dit als twee actieve registraties en telt het mee in de abonnementcapaciteit. -
unclaimedPasses(Niet-geclaimde passen): Live pasinstanties die in Passinstance zijn uitgegeven maar nog nooit in een wallet zijn opgeslagen. -
inactivePasses(Verwijderde passen): Live pasinstanties die eerder in een wallet waren opgeslagen, maar geen bereikbare apparaatregistraties meer hebben (inclusief AppleDELETE /v1/devices/...en Googledel-callbacks naar/api/v1/wallet/callback). -
voidedPasses(Ongeldig verklaarde passen) &expiredPasses(Verlopen passen): Pasinstanties die aan de serverzijde zijn ingetrokken of waarvanexpirationDateis verstreken.
Workspace-instellingen & regionale configuratie
Elke workspace wordt afzonderlijk geconfigureerd onder Instellingen -> Workspace (/settings/workspace/*):
-
Algemene & regionale instellingen (
PUT /api/v1/customer/:customerId/regional-settings): Configureert de standaardtijdzone (resolveCustomerTimeZone), de standaard ISO 4217-valutacode en de taallocale. -
Gebruiksquota (
GET /api/v1/customer/:customerId/usage-summary): Rapporteert realtime totaal aantallen passen, actieve passen afgezet tegenmaxActivePassesen aantallen sjablonen. -
Whitelabel eigen domeinen (
/api/v1/white-labeling/vanity-urls): Koppelt aangepaste domeinen (domain surface type:PASS_DOWNLOAD,PASS_FLOW,BACKEND_UI, enz.) met geautomatiseerde SSL-provisioning voor alle slimme links en downloadpagina's.
Belangrijk: Sandbox-workspaces bieden een geïsoleerde omgeving om sjabloonrevisies, API-webhooks en scannerconfiguraties te testen zonder actieve pascapaciteit van uw productieabonnement te verbruiken.
