Entrega de credenciales
La distribución: un enlace que es el QR, el correo y la etiqueta.
Una distribución acuña un enlace para una credencial y lo devuelve. Ese enlace es la entrega entera: dibujado es un QR, escrito es una etiqueta NFC, dentro de un mensaje es un correo.
POST/v1/distributions
Entrega una credencial a alguien, por un canal, para una cartera.
| Campo | Valores |
|---|---|
credentialId | La credencial que se entrega. Obligatorio. |
channel | link, qr, email, api, web, app, nfc — cómo viaja. |
wallet | apple_wallet, google_wallet, web — dónde termina el pase. |
recipientName, recipientEmail | Para quién es. Obligatorio en correo. |
message | Una línea que ve quien la recibe. |
expiresAt | Cuándo deja de servir el enlace. |
201 Created
{
"id": "…",
"url": "https://…",
"code": "…",
"channel": "qr",
"wallet": "apple_wallet",
"status": "ready",
"credential": { "id": "cred_…", "serial": "…", "state": "issued" }
}Retirar un enlace
POST /v1/distributions/{id}/revoke mata un enlace sin tocar la credencial — la llamada correcta cuando un mensaje salió a la dirección equivocada. POST /v1/distributions/{id}/regenerate acuña otro en su lugar.