Saúde do espaço de trabalho e telemetria em direto
Cada conta Passinstance opera dentro de um espaço de trabalho tenant estritamente particionado. Todos os ativos criados num espaço de trabalho — incluindo modelos visuais, certificados criptográficos de assinatura, propriedades personalizadas, registos de passes dos clientes, segredos de API e histórico de leituras em ponto de venda — estão associados ao ID do seu espaço de trabalho (customerId) e completamente isolados de outras organizações.

Arquitetura multi-tenant e hierarquia do espaço de trabalho
A Passinstance implementa uma hierarquia organizacional em dois níveis que separa a governação de faturação da conta da gestão diária de passes:
Gerir espaços de trabalho irmãos via API Organization
As equipas que gerem várias marcas, contas de clientes ou ambientes sandbox podem interagir com o Organizations API:
| Caminho do endpoint | Método | Autenticação | Funcionalidade | |
|---|---|---|---|---|
/api/v1/organizations/current | GET | Bearer | Devolve a organização ativa, os perfis de membros e a lista de espaços de trabalho irmãos acessíveis. | |
/api/v1/organizations/current/billing-summary | GET | Bearer | Consolidação dos limites do plano e contagens acumuladas de passes ativos em todos os espaços de trabalho. | |
/api/v1/organizations/current/workspaces | POST | Bearer | Cria um novo espaço de trabalho irmão (`kind: "production" \ | "sandbox"`). |
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Alterna o contexto de tenant ativo e roda os cookies de sessão de autenticação. |
Taxonomia das principais métricas de telemetria
Para monitorizar o seu programa de passes com precisão, a Passinstance distingue entre a criação do registo no servidor e a instalação física na carteira:
Passe Criado (POST /api/v1/passes) =================> unclaimedPasses (Não Instalados)
|
| Cliente Adiciona à Carteira
v
Dispositivo Registado (POST /v1/devices/...) =======> installedDevices (Instalados)
|
| Cliente Elimina da Carteira
v
Dispositivo Anulado (DELETE /v1/devices/...) =======> inactivePasses / inactiveDeviceRegistrations
Definições de metric-definitions.ts
-
totalPasses(Total Passes Issued): Contagem acumulada de registos de passes ativos gerados no seu espaço de trabalho que não foram eliminados no momento da captura. -
activePasses(Active Passes): Instâncias de passes ativas que possuem atualmente pelo menos um registo de dispositivo alcançável (excluindo passes expirados e anulados). -
installedDevices(Active Device Registrations): Registos de passes guardados alcançáveis entre Apple APNs e Google Wallet. Se um passe estiver guardado em dois dispositivos, conta como dois registos ativos e consome capacidade do plano. -
unclaimedPasses(Unclaimed Passes): Instâncias de passes ativas emitidas na Passinstance que nunca foram guardadas numa carteira. -
inactivePasses(Removed Passes): Instâncias de passes ativas que foram anteriormente guardadas numa carteira, mas já não possuem registos de dispositivos alcançáveis (incluindoDELETE /v1/devices/...da Apple e callbacksdelda Google para/api/v1/wallet/callback). -
voidedPasses(Voided Passes) eexpiredPasses(Expired Passes): Instâncias de passes revogadas no servidor ou apósexpirationDate.
Definições do espaço de trabalho e configuração regional
Cada espaço de trabalho é configurado de forma independente em Definições -> Espaço de Trabalho (/settings/workspace/*):
-
Definições Gerais e Regionais (
PUT /api/v1/customer/:customerId/regional-settings): Configura o fuso horário predefinido (resolveCustomerTimeZone), o código de moeda ISO 4217 predefinido e o idioma. -
Quotas de Utilização (
GET /api/v1/customer/:customerId/usage-summary): Reporta em tempo real o total de passes, passes ativos face amaxActivePassese contagens de modelos. -
Domínios Próprios Whitelabel (
/api/v1/white-labeling/vanity-urls): Liga domínios personalizados (domain surface type:PASS_DOWNLOAD,PASS_FLOW,BACKEND_UI, etc.) com provisionamento automático de SSL para todas as ligações inteligentes e páginas de download.
Importante: Os espaços de trabalho Sandbox fornecem um ambiente isolado para testar revisões de modelos, webhooks da API e configurações de scanner sem consumir capacidade de passes ativos do seu plano de produção.
