Ondersteuningskanalen en diagnostische telemetrie
Wanneer u technische ondersteuning, begeleiding bij de onboarding of incidenttriage nodig hebt, stelt het meesturen van gestructureerde diagnostische ID's het ondersteuningsteam van Passinstance in staat om uw exacte API-verzoek, achtergrondtaak of wallet-callback onmiddellijk te traceren.
-
Directe servicedesk: support@passinstance.com
-
Webformulier: Contact opnemen met Passinstance
-
Begeleide pilot- en non-profitaanvraag: Een pilot aanvragen
-
Productwijzigingslogboek: Release-opmerkingen
Vereiste diagnostische ID's voor een snelle oplossing
Neem de volgende ID's (indien van toepassing) op in uw ondersteuningsticket, zodat engineers logboeken direct kunnen correleren zonder vertraging door heen-en-weer gemail:
| Diagnostische ID | Voorbeeldformaat | Waar u deze vindt |
|---|---|---|
Request Correlation ID (requestId) | req_8f192b0e4c12 | Geretourneerd in elke JSON-foutpayload van API Error Handler en in de x-request-id-antwoordheader. |
Template ID (templateId) & bundleId | 8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2b | Weergegeven in de URL van de sjablooneditor of geretourneerd door GET /api/v1/templates (bundleId = Apple passTypeIdentifier). |
Pass Serial / externalId | PASS-2026-99412 | Zichtbaar op de achterkant van de wallet-pas, in de tabel Passen of in passSnapshot in the scan response. |
Webhook ID (webhookId) | wh_55a9c102e4b1 | Meegezonden in de HTTP-header X-Webhook-Id bij uitgaande push-webhooks of opgevraagd via GET /webhook-payload. |
| Client-OS & browser | iOS 18.2 Safari / Android 15 Chrome | Handig bij het diagnosticeren van problemen met het downloaden van passen of het installeren in de wallet door pashouders. |
Belangrijk: Stuur nooit onbewerkte API-sleutels (
pi_live_...), scannersleutels, accountwachtwoorden of wachtwoorden van Apple.p12-certificaten mee in ondersteuningsmails of tickets. Engineers van Passinstance hebben uw geheime sleutels nooit nodig om uw werkruimte te inspecteren.
Openbare eindpunten voor contact en operationele gezondheid
Integrators en monitoringsystemen communiceren met Support Intake API (/api/v1/contact*) en de prefixvrije Health Check API (/health*):
| Eindpuntpad | Methode | Auth | Beschrijving |
|---|---|---|---|
/api/v1/contact | POST | Public | Dient een gestructureerde ondersteunings- of verkoopvraag in (name, email, company, message). |
/api/v1/contact/subscribe | POST | Public | Abonneert een e-mailadres op platformreleases en operationele aankondigingen. |
/health | GET | Public | Standaard gezondheidscontrole die de gereedheid van de kern-database en -in-memory cache verifieert. |
/health/liveness | GET | Public | Lichtgewicht liveness-probe voor containers die de responsiviteit van de HTTP-server bevestigt. |
/health/readiness | GET | Public | Verifieert de gereedheid van de databasepool en cache voordat inkomend verkeer wordt geaccepteerd. |
/health/detailed | GET | Bearer / Ops | Retourneert de gedetailleerde subsysteemstatus voor Database, in-memory cache, Google Wallet API, achtergrondwachtrijen, Mailer en webhook-Circuit Breakers. |
Voorbeeld: Gedetailleerde subsysteemgezondheid inspecteren (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 }
}
}
Een ondersteuningsvraag indienen via de 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)."
}
Voor directe zelfbedieningsdiagnostiek raadpleegt u Probleemoplossing en veelgestelde vragen en Bekende problemen en beperkingen.
