Santé de l'espace de travail & télémétrie en direct
Chaque compte Passinstance fonctionne au sein d'un espace de travail locataire strictement cloisonné. Tous les actifs créés dans un espace — modèles visuels, certificats cryptographiques de signature, propriétés personnalisées, fiches de passes clients, secrets d'API et historique des scans en point de vente — sont rattachés à votre identifiant d'espace (customerId) et totalement isolés des autres organisations.

Architecture multi-locataire & hiérarchie des espaces
Passinstance repose sur une hiérarchie organisationnelle à deux niveaux qui sépare la gouvernance de facturation du compte de la gestion quotidienne des passes :
Gérer les espaces frères via l'API Organization
Les équipes qui gèrent plusieurs marques, comptes clients ou environnements sandbox peuvent interagir avec Organizations API :
| Chemin d'endpoint | Méthode | Auth | Fonctionnalité | |
|---|---|---|---|---|
/api/v1/organizations/current | GET | Bearer | Retourne l'organisation active, les rôles des membres et la liste des espaces frères accessibles. | |
/api/v1/organizations/current/billing-summary | GET | Bearer | Récapitulatif des limites du forfait et du cumul de passes actifs sur tous les espaces. | |
/api/v1/organizations/current/workspaces | POST | Bearer | Crée un nouvel espace de travail frère (`kind: "production" \ | "sandbox"`). |
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Bascule le contexte locataire actif et renouvelle les cookies de session. |
Taxonomie des métriques de télémétrie principales
Pour piloter précisément votre programme de passes, Passinstance distingue la création d'un enregistrement côté serveur de son installation physique dans un portefeuille :
Passe créé (POST /api/v1/passes) ================> unclaimedPasses (Non installés)
|
| Client ajoute au Wallet
v
Appareil enregistré (POST /v1/devices/...) ======> installedDevices (Installés)
|
| Client supprime du Wallet
v
Appareil désinscrit (DELETE /v1/devices/...) ====> inactivePasses / inactiveDeviceRegistrations
Définitions issues de metric-definitions.ts
-
totalPasses(Total Passes Issued) : nombre cumulé de fiches de passes actives générées dans votre espace de travail et non supprimées au moment de la mesure. -
activePasses(Active Passes) : instances de passes actives disposant actuellement d'au moins un enregistrement d'appareil joignable (hors passes expirés et annulés). -
installedDevices(Active Device Registrations) : inscriptions de passes enregistrées et joignables sur Apple APNs et Google Wallet. Si un même passe est installé sur deux appareils, il compte pour deux inscriptions actives et est comptabilisé dans la capacité du forfait. -
unclaimedPasses(Unclaimed Passes) : instances de passes émises dans Passinstance qui n'ont encore jamais été ajoutées à un portefeuille. -
inactivePasses(Removed Passes) : instances de passes précédemment enregistrées dans un portefeuille mais qui n'ont plus aucun appareil joignable (y compris via AppleDELETE /v1/devices/...et les rappels Googledelsur/api/v1/wallet/callback). -
voidedPasses(Voided Passes) &expiredPasses(Expired Passes) : instances révoquées côté serveur ou ayant dépasséexpirationDate.
Paramètres de l'espace de travail & configuration régionale
Chaque espace se configure indépendamment sous Settings -> Workspace (/settings/workspace/*) :
-
Paramètres généraux et régionaux (
PUT /api/v1/customer/:customerId/regional-settings) : définit le fuseau horaire par défaut (resolveCustomerTimeZone), la devise ISO 4217 par défaut et la langue par défaut. -
Quotas d'utilisation (
GET /api/v1/customer/:customerId/usage-summary) : indique en temps réel le total des passes, les passes actifs face àmaxActivePasseset le nombre de modèles. -
Domaines personnalisés en marque blanche (
/api/v1/white-labeling/vanity-urls) : connecte vos propres noms de domaine (domain surface type :PASS_DOWNLOAD,PASS_FLOW,BACKEND_UI, etc.) avec provisionnement SSL automatisé pour tous vos liens intelligents et pages de téléchargement.
Important : Les espaces de travail Sandbox offrent un environnement isolé pour tester des révisions de modèles, des webhooks API et des configurations scanner sans consommer de capacité de passes actifs sur votre forfait de production.
