Skip to content
Référence API REST & SDKs

Documentation Développeur Passinstance

Créez des intégrations Apple Wallet (.pkpass) et Google Wallet à grande échelle. Émettez, mettez à jour, validez et diffusez des notifications en direct via des API REST prêtes pour la production.

Obtenir les clés API
Atelier docs en direct — les extraits se mettent à jour en temps réel

Gestion des lots

4 points de terminaison
POSThttps://api.passinstance.com/api/v1/bundles/upsertClé API
Gestion des lots

Créer ou mettre à jour un lot de cartes

Créez ou mettez à jour un lot multi-cartes (.pkpasses) permettant aux utilisateurs d'installer plusieurs cartes liées en un seul geste.

En-têtes1 requis
X-API-Keystring
Requis

Clé API secrète de l'espace de travail (pi_live_... ou pi_test_...). Vous pouvez également envoyer Authorization: ApiKey <key>.

Exemple : pi_live_98a7b6c5d4e3f2a1

Array of pass UUIDs (up to 10) and optional existing bundleId.

Corps de la requête1 requis • 1 optionnel(s)
passesstring[] (UUID)
Requis

Tableau de 1 à 10 UUID de cartes à regrouper dans le lot.

Exemple : ["b1d972dc-eccf-4f87-ab21-25939d9213d8", "c2e083ed-fddf-4a98-bc32-36040e0324e9"]

Codes de statut de réponse

GEThttps://api.passinstance.com/api/v1/bundles/{id}/passesClé API
Gestion des lots

Lister les cartes du lot

Listez toutes les cartes individuelles actuellement associées à un lot de cartes, avec leur statut et numéro de série.

En-têtes1 requis
X-API-Keystring
Requis

Clé API secrète de l'espace de travail (pi_live_... ou pi_test_...). Vous pouvez également envoyer Authorization: ApiKey <key>.

Exemple : pi_live_98a7b6c5d4e3f2a1
Paramètres de chemin1 requis
idstring (UUID)
Requis

UUID du lot de cartes.

Exemple : e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b
Paramètres de requête3 optionnel(s)

Codes de statut de réponse

POSThttps://api.passinstance.com/api/v1/bundles/{id}/voidClé API
Gestion des lots

Annuler les cartes du lot

Annulez ou réactivez toutes les cartes appartenant à un lot de cartes en une seule opération.

En-têtes1 requis
X-API-Keystring
Requis

Clé API secrète de l'espace de travail (pi_live_... ou pi_test_...). Vous pouvez également envoyer Authorization: ApiKey <key>.

Exemple : pi_live_98a7b6c5d4e3f2a1
Paramètres de chemin1 requis
idstring (UUID)
Requis

UUID du lot de cartes.

Exemple : e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b

Confirmation flag and optional audit reason for voiding all passes in the bundle.

Corps de la requête1 requis • 1 optionnel(s)
voidedboolean
Requis

Doit être défini sur true pour annuler toutes les cartes du lot.

Exemple : true

Codes de statut de réponse

DELETEhttps://api.passinstance.com/api/v1/bundles/{id}Clé API
Gestion des lots

Supprimer le lot de cartes

Supprimez un conteneur de lot de cartes de votre espace de travail.

En-têtes1 requis
X-API-Keystring
Requis

Clé API secrète de l'espace de travail (pi_live_... ou pi_test_...). Vous pouvez également envoyer Authorization: ApiKey <key>.

Exemple : pi_live_98a7b6c5d4e3f2a1
Paramètres de chemin1 requis
idstring (UUID)
Requis

UUID du lot de cartes à supprimer.

Exemple : e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b

Codes de statut de réponse