Skip to content
Referencia de API REST y SDKs

Documentación para desarrolladores de Passinstance

Cree integraciones de alto volumen con Apple Wallet (.pkpass) y Google Wallet. Emita, actualice, escanee y envíe notificaciones en tiempo real mediante APIs REST de nivel de producción.

Obtener claves API
Entorno interactivo — los fragmentos se actualizan mientras escribes

Gestión de paquetes

4 endpoints
POSThttps://api.passinstance.com/api/v1/bundles/upsertClave API
Gestión de paquetes

Crear o actualizar paquete de pases

Cree o actualice un paquete multipase (.pkpasses) que permite a los usuarios instalar varios pases relacionados en un solo toque.

Encabezados1 obligatorio(s)
X-API-Keystring
Obligatorio

Clave API secreta del espacio de trabajo (pi_live_... o pi_test_...). Alternativamente puede enviar Authorization: ApiKey <key>.

Ejemplo: pi_live_98a7b6c5d4e3f2a1

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

Cuerpo de la solicitud1 obligatorio(s) • 1 opcional(es)
passesstring[] (UUID)
Obligatorio

Lista de 1 a 10 UUID de pases para agrupar en el paquete.

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

Códigos de estado de respuesta

GEThttps://api.passinstance.com/api/v1/bundles/{id}/passesClave API
Gestión de paquetes

Listar pases en el paquete

Liste todos los pases individuales asociados actualmente a un paquete de pases, incluyendo su estado y números de serie.

Encabezados1 obligatorio(s)
X-API-Keystring
Obligatorio

Clave API secreta del espacio de trabajo (pi_live_... o pi_test_...). Alternativamente puede enviar Authorization: ApiKey <key>.

Ejemplo: pi_live_98a7b6c5d4e3f2a1
Parámetros de ruta1 obligatorio(s)
idstring (UUID)
Obligatorio

UUID del paquete de pases.

Ejemplo: e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b
Parámetros de consulta3 opcional(es)

Códigos de estado de respuesta

POSThttps://api.passinstance.com/api/v1/bundles/{id}/voidClave API
Gestión de paquetes

Anular pases del paquete

Anule o reactive todos los pases pertenecientes a un paquete de pases en una sola operación.

Encabezados1 obligatorio(s)
X-API-Keystring
Obligatorio

Clave API secreta del espacio de trabajo (pi_live_... o pi_test_...). Alternativamente puede enviar Authorization: ApiKey <key>.

Ejemplo: pi_live_98a7b6c5d4e3f2a1
Parámetros de ruta1 obligatorio(s)
idstring (UUID)
Obligatorio

UUID del paquete de pases.

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

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

Cuerpo de la solicitud1 obligatorio(s) • 1 opcional(es)
voidedboolean
Obligatorio

Debe establecerse en true para anular todos los pases del paquete.

Ejemplo: true

Códigos de estado de respuesta

DELETEhttps://api.passinstance.com/api/v1/bundles/{id}Clave API
Gestión de paquetes

Eliminar paquete de pases

Elimine un contenedor de paquete de pases de su espacio de trabajo.

Encabezados1 obligatorio(s)
X-API-Keystring
Obligatorio

Clave API secreta del espacio de trabajo (pi_live_... o pi_test_...). Alternativamente puede enviar Authorization: ApiKey <key>.

Ejemplo: pi_live_98a7b6c5d4e3f2a1
Parámetros de ruta1 obligatorio(s)
idstring (UUID)
Obligatorio

UUID del paquete de pases que se desea eliminar.

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

Códigos de estado de respuesta