Skip to content
Riferimento API REST e SDK

Documentazione per sviluppatori Passinstance

Crea integrazioni su larga scala per Apple Wallet (.pkpass) e Google Wallet. Emetti, aggiorna, scansiona e invia notifiche in tempo reale tramite API REST pronte per la produzione.

Ottieni chiavi API
Workbench live — gli snippet si aggiornano mentre digiti

Gestione pacchetti

4 endpoint
POSThttps://api.passinstance.com/api/v1/bundles/upsertChiave API
Gestione pacchetti

Crea o aggiorna pacchetto pass

Crea o aggiorna un pacchetto multi-pass (.pkpasses) che consente agli utenti di installare più pass correlati con un solo tocco.

Intestazioni1 obbligatori
X-API-Keystring
Obbligatorio

Chiave API segreta del workspace (pi_live_... o pi_test_...). In alternativa è possibile inviare Authorization: ApiKey <key>.

Esempio: pi_live_98a7b6c5d4e3f2a1

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

Corpo della richiesta1 obbligatori • 1 opzionali
passesstring[] (UUID)
Obbligatorio

Array da 1 a 10 UUID di pass da raggruppare nel pacchetto.

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

Codici di stato della risposta

GEThttps://api.passinstance.com/api/v1/bundles/{id}/passesChiave API
Gestione pacchetti

Elenca pass nel pacchetto

Elenca tutti i singoli pass attualmente associati a un pacchetto di pass, inclusi stato e numeri di serie.

Intestazioni1 obbligatori
X-API-Keystring
Obbligatorio

Chiave API segreta del workspace (pi_live_... o pi_test_...). In alternativa è possibile inviare Authorization: ApiKey <key>.

Esempio: pi_live_98a7b6c5d4e3f2a1
Parametri di percorso1 obbligatori
idstring (UUID)
Obbligatorio

UUID del pacchetto pass.

Esempio: e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b
Parametri di query3 opzionali

Codici di stato della risposta

POSThttps://api.passinstance.com/api/v1/bundles/{id}/voidChiave API
Gestione pacchetti

Annulla pass del pacchetto

Annulla o riattiva tutti i pass appartenenti a un pacchetto di pass in un'unica operazione.

Intestazioni1 obbligatori
X-API-Keystring
Obbligatorio

Chiave API segreta del workspace (pi_live_... o pi_test_...). In alternativa è possibile inviare Authorization: ApiKey <key>.

Esempio: pi_live_98a7b6c5d4e3f2a1
Parametri di percorso1 obbligatori
idstring (UUID)
Obbligatorio

UUID del pacchetto pass.

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

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

Corpo della richiesta1 obbligatori • 1 opzionali
voidedboolean
Obbligatorio

Deve essere impostato su true per annullare tutti i pass nel pacchetto.

Esempio: true

Codici di stato della risposta

DELETEhttps://api.passinstance.com/api/v1/bundles/{id}Chiave API
Gestione pacchetti

Elimina pacchetto pass

Elimina un contenitore di pacchetto pass dal tuo workspace.

Intestazioni1 obbligatori
X-API-Keystring
Obbligatorio

Chiave API segreta del workspace (pi_live_... o pi_test_...). In alternativa è possibile inviare Authorization: ApiKey <key>.

Esempio: pi_live_98a7b6c5d4e3f2a1
Parametri di percorso1 obbligatori
idstring (UUID)
Obbligatorio

UUID del pacchetto pass da eliminare.

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

Codici di stato della risposta