Ciclo de vida
Los cinco estados, cada transición entre ellos, y qué hace el teléfono al respecto.
Emitir es la parte fácil. Lo que hace que una credencial valga la pena es que deje de valer en el momento justo, en todos los lugares donde se mostró.
| Estado | Significa | Reversible |
|---|---|---|
draft | Creada, todavía sin emitir. | — |
issued | Vigente y honrable. | — |
suspended | Temporalmente sin valer. El pase sigue en el teléfono y lo dice. | Sí — resume |
expired | Pasada su vigencia. Se llega solo, no con una llamada. | No |
revoked | Terminada a propósito, con motivo y autor en el registro. | No |
Las transiciones
POST /v1/credentials/{id}/suspend— la pausa.POST /v1/credentials/{id}/resume— devuelve una credencial suspendida.POST /v1/credentials/{id}/revoke— la termina para siempre.PATCH /v1/credentials/{id}— cambia lo que dice sin tocar su estado.POST /v1/credentials/bulk— aplicasuspend,resume,revokeoexpirea una lista.
Qué hace la cartera
Un cambio marca como stale cada cartera que tiene la credencial y le manda la versión nueva. Las dos carteras no son simétricas: un pase de Apple es un archivo que el dispositivo guarda y se actualiza con un aviso, mientras que un objeto de Google Wallet es un registro que guarda Google y se actualiza en su sitio. Nomi opera los dos lados; lo que tú ves es una credencial y una lista de estados de canal.
Historia
GET /v1/credentials/{id}/events devuelve el rastro de una credencial, del más reciente al más viejo: emitida, actualizada, verificada, rechazada, suspendida, revocada, cada uno con su autor y su momento. Es la respuesta a «¿por qué no dejaron entrar a esta persona el martes?», que es la pregunta que de verdad llega.