Canais de Suporte e Telemetria de Diagnóstico
Quando necessitar de assistência de engenharia, orientação de integração ou triagem de incidentes, contactar-nos com identificadores de diagnóstico estruturados permite que a equipa de suporte do Passinstance rastreie imediatamente o seu pedido exato de API, tarefa em segundo plano ou callback da carteira.
-
Balcão de Suporte Direto: support@passinstance.com
-
Formulário Web de Contacto: Contactar o Passinstance
-
Admissão a Piloto Acompanhado e Organizações Sem Fins Lucrativos: Solicitar um Piloto
-
Registo de Alterações do Produto: Notas de Lançamento
Identificadores de Diagnóstico Necessários para Resolução Rápida
Inclua os seguintes identificadores (quando aplicável) no seu pedido de suporte para que os engenheiros possam correlacionar registos sem atrasos de comunicação:
| Identificador de Diagnóstico | Formato de Exemplo | Onde Encontrar |
|---|---|---|
ID de Correlação do Pedido (requestId) | req_8f192b0e4c12 | Devolvido em todos os payloads de erro JSON de API Error Handler e no cabeçalho de resposta x-request-id. |
ID do Modelo (templateId) e bundleId | 8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2b | Apresentado no URL do Editor de Modelos ou devolvido por GET /api/v1/templates (bundleId = passTypeIdentifier da Apple). |
Número de Série do Passe / externalId | PASS-2026-99412 | Apresentado no verso do passe na carteira, na tabela de Passes ou em passSnapshot in the scan response. |
ID do Webhook (webhookId) | wh_55a9c102e4b1 | Enviado no cabeçalho HTTP X-Webhook-Id nos webhooks push de saída ou consultado através de GET /webhook-payload. |
| Sistema Operativo e Navegador do Cliente | iOS 18.2 Safari / Android 15 Chrome | Útil ao diagnosticar problemas de transferência pelo titular do passe ou de instalação na carteira. |
Importante: Nunca envie chaves de API brutas (
pi_live_...), chaves de leitor, palavras-passe de conta ou palavras-passe de certificados.p12da Apple em e-mails ou pedidos de suporte. Os engenheiros do Passinstance nunca necessitam das suas chaves secretas para inspecionar o seu espaço de trabalho.
Endpoints Públicos de Contacto e Saúde Operacional
Os integradores e sistemas de monitorização interagem com Support Intake API (/api/v1/contact*) e com Health Check API sem prefixo (/health*):
| Caminho do Endpoint | Método | Autenticação | Descrição |
|---|---|---|---|
/api/v1/contact | POST | Pública | Submete um pedido estruturado de suporte ou comercial (name, email, company, message). |
/api/v1/contact/subscribe | POST | Pública | Subscreve um endereço de e-mail para anúncios de versões e operações da plataforma. |
/health | GET | Pública | Verificação de saúde padrão que confirma a prontidão principal do database e do in-memory cache. |
/health/liveness | GET | Pública | Sonda ligeira de atividade do contentor que confirma a capacidade de resposta do servidor HTTP. |
/health/readiness | GET | Pública | Verifica a prontidão do conjunto de ligações à base de dados e da cache antes de aceitar tráfego de entrada. |
/health/detailed | GET | Bearer / Ops | Devolve o estado granular dos subsistemas na Base de Dados, in-memory cache, API Google Wallet, filas de tarefas em segundo plano, Mailer e Disjuntores de webhooks. |
Exemplo: Inspecionar a Saúde Detalhada dos Subsistemas (GET /health/detailed)
{
"status": "ok",
"timestamp": "2026-11-15T22:30:00.000Z",
"components": {
"database": { "status": "up", "latencyMs": 3 },
"cache": { "status": "up", "latencyMs": 1 },
"googleWalletApi": { "status": "up" },
"jobQueue": { "status": "up", "activeJobs": 4 },
"mailer": { "status": "up" },
"circuitBreakers": { "openWebhooks": 0 }
}
}
Submeter um Pedido de Suporte via API (POST /api/v1/contact)
{
"name": "Marcus Vance",
"email": "marcus@retailops.example.com",
"company": "Vance Retail Group",
"message": "Investigating webhook circuit breaker cooldown on webhookId wh_55a9c102e4b1 (requestId: req_8f192b0e4c12)."
}
Para diagnósticos imediatos em autoatendimento, consulte Resolução de Problemas e Perguntas Frequentes e Problemas Conhecidos e Limitações.
