Canali di supporto e telemetria diagnostica
Quando necessita di assistenza tecnica, guida all'onboarding o analisi di un incidente, contattarci fornendo identificativi diagnostici strutturati consente al team di supporto di Passinstance di rintracciare immediatamente l'esatta richiesta API, il processo in background o il callback del wallet.
-
Helpdesk di supporto diretto: support@passinstance.com
-
Modulo di contatto web: Contatti Passinstance
-
Richiesta guidata Pilot e Non-Profit: Richieda un progetto pilota
-
Changelog di prodotto: Note di rilascio
Identificativi diagnostici richiesti per una risoluzione rapida
Includa i seguenti identificativi (ove applicabile) nel Suo ticket di supporto affinché i tecnici possano correlare i log senza ritardi dovuti a ulteriori scambi di messaggi:
| Identificativo diagnostico | Formato di esempio | Dove trovarlo |
|---|---|---|
ID di correlazione della richiesta (requestId) | req_8f192b0e4c12 | Restituito in ogni payload di errore JSON di API Error Handler e nell'header di risposta x-request-id. |
ID del modello (templateId) e bundleId | 8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2b | Visualizzato nell'URL dell'Editor di modelli o restituito da GET /api/v1/templates (bundleId = passTypeIdentifier di Apple). |
Seriale del pass / externalId | PASS-2026-99412 | Mostrato sul retro del pass nel wallet, nella tabella dei pass o in passSnapshot in the scan response. |
ID del webhook (webhookId) | wh_55a9c102e4b1 | Inviato nell'header HTTP X-Webhook-Id sui webhook push in uscita o interrogato tramite GET /webhook-payload. |
| Sistema operativo e browser del client | iOS 18.2 Safari / Android 15 Chrome | Utile per diagnosticare problemi di download del titolare del pass o di installazione nel wallet. |
Importante: Non invii mai chiavi API in chiaro (
pi_live_...), chiavi dello scanner, password dell'account o password dei certificati.p12di Apple nelle email o nei ticket di supporto. I tecnici di Passinstance non richiedono mai le Sue chiavi segrete per ispezionare il Suo workspace.
Endpoint pubblici di contatto e salute operativa
Gli integratori e i sistemi di monitoraggio interagiscono con Support Intake API (/api/v1/contact*) e con Health Check API senza prefisso (/health*):
| Percorso Endpoint | Metodo | Autenticazione | Descrizione |
|---|---|---|---|
/api/v1/contact | POST | Pubblico | Invia una richiesta strutturata di supporto o commerciale (name, email, company, message). |
/api/v1/contact/subscribe | POST | Pubblico | Iscrive un indirizzo email agli annunci di rilascio e operativi della piattaforma. |
/health | GET | Pubblico | Controllo di salute standard che verifica la prontezza di base di database e in-memory cache. |
/health/liveness | GET | Pubblico | Sonda leggera di vitalità del container che conferma la reattività del server HTTP. |
/health/readiness | GET | Pubblico | Verifica la prontezza del pool di database e della cache prima di accettare il traffico in ingresso. |
/health/detailed | GET | Bearer / Ops | Restituisce lo stato granulare dei sottosistemi tra Database, in-memory cache, API Google Wallet, code di lavoro in background, Mailer e Circuit Breaker dei webhook. |
Esempio: ispezione dettagliata della salute dei sottosistemi (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 }
}
}
Invio di una richiesta di supporto tramite 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)."
}
Per una diagnostica self-service immediata, consulti Risoluzione dei problemi e domande frequenti e Problemi noti e limitazioni.
