Canaux de support et télémétrie de diagnostic
Lorsque vous avez besoin d'une assistance technique, d'un accompagnement à l'intégration ou du traitement d'un incident, le fait de nous contacter en fournissant des identifiants de diagnostic structurés permet à l'équipe de support Passinstance de retracer immédiatement votre requête API exacte, votre tâche en arrière-plan ou votre callback de portefeuille.
-
Service de support direct : support@passinstance.com
-
Formulaire de contact Web : Contacter Passinstance
-
Demande de pilote guidé et associations : Demander un pilote
-
Journal des modifications du produit : Notes de version
Identifiants de diagnostic requis pour une résolution rapide
Incluez les identifiants suivants (le cas échéant) dans votre ticket de support afin que nos ingénieurs puissent corréler les journaux sans échanges supplémentaires :
| Identifiant de diagnostic | Exemple de format | Où le trouver |
|---|---|---|
ID de corrélation de requête (requestId) | req_8f192b0e4c12 | Renvoyé dans chaque charge utile d'erreur JSON API Error Handler et dans l'en-tête de réponse x-request-id. |
ID de modèle (templateId) & bundleId | 8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2b | Affiché dans l'URL de l'éditeur de modèles ou renvoyé par GET /api/v1/templates (bundleId = passTypeIdentifier Apple). |
Numéro de série du pass / externalId | PASS-2026-99412 | Affiché au verso du pass dans le portefeuille, dans le tableau Passes ou dans passSnapshot in the scan response. |
ID de webhook (webhookId) | wh_55a9c102e4b1 | Envoyé dans l'en-tête HTTP X-Webhook-Id sur les webhooks sortants ou consulté via GET /webhook-payload. |
| OS et navigateur du client | iOS 18.2 Safari / Android 15 Chrome | Utile lors du diagnostic de problèmes de téléchargement ou d'installation dans le portefeuille d'un détenteur de pass. |
Important : N'envoyez jamais de clés API brutes (
pi_live_...), de clés de scanner, de mots de passe de compte ou de mots de passe de certificats Apple.p12dans vos e-mails ou tickets de support. Les ingénieurs de Passinstance n'ont jamais besoin de vos clés secrètes pour inspecter votre espace de travail.
Points de terminaison publics de contact et de santé opérationnelle
Les intégrateurs et les systèmes de supervision interagissent avec Support Intake API (/api/v1/contact*) et Health Check API sans préfixe (/health*) :
| Chemin du point de terminaison | Méthode | Auth | Description |
|---|---|---|---|
/api/v1/contact | POST | Public | Soumet une demande structurée de support ou commerciale (name, email, company, message). |
/api/v1/contact/subscribe | POST | Public | Abonne une adresse e-mail aux annonces de nouvelles versions et aux communications opérationnelles de la plateforme. |
/health | GET | Public | Vérification de santé standard contrôlant la disponibilité de base de database et in-memory cache. |
/health/liveness | GET | Public | Sonde légère de vivacité du conteneur confirmant la réactivité du serveur HTTP. |
/health/readiness | GET | Public | Vérifie la disponibilité du pool de base de données et du cache avant d'accepter le trafic entrant. |
/health/detailed | GET | Bearer / Ops | Renvoie l'état granulaire des sous-systèmes pour la base de données, in-memory cache, l'API Google Wallet, les files de tâches en arrière-plan, le Mailer et les disjoncteurs de webhooks. |
Exemple : Inspection détaillée de la santé des sous-systèmes (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 }
}
}
Soumission d'une demande de support via l'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)."
}
Pour un autodiagnostic immédiat, consultez Dépannage et FAQ ainsi que Problèmes connus et limitations.
