Inicio rápido

De una llave de API a una credencial en un teléfono, en cuatro solicitudes.

Cuatro solicitudes: crear una llave, dar de alta a la persona, definir qué recibe y emitírsela. Todo lo de abajo es un endpoint real con su cuerpo real — si todavía no tienes llave, empieza por Autenticación.

1. 1

   Crea una llave de API

   En la consola, en Configuración. Se muestra una sola vez, empieza con nomi_sk_live_ y pertenece a una organización.

2. 2

   Da de alta a la persona

   Los subjects llevan tu propio identificador como llave, así que la misma llamada puede correr dos veces sin crear dos personas.

3. 3

   Define la credencial

   Una plantilla dice qué muestra la credencial y de dónde sale cada valor en el subject. Publica una versión antes de emitir contra ella.

4. 4

   Emítela

   La credencial se crea y pasa a issued; las carteras vuelven en pending mientras se renderizan.

1. Dar de alta un subject

curl -X PUT https://api.nomi-tech.com/v1/subjects \
  -H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "crm_example_001",
    "displayName": "Alex Morgan",
    "email": "alex@example.com",
    "attributes": { "tier": "Platinum", "memberSince": "2021-03-04" }
  }'

La respuesta trae el id del subject — sub_… —, que es lo que necesita la llamada siguiente. PUT es idempotente sobre externalId: correr tu sincronización dos veces produce un subject, no dos.

2. Emitir una credencial

curl -X POST https://api.nomi-tech.com/v1/credentials \
  -H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_example_12345" \
  -d '{
    "subjectId": "sub_…",
    "templateKey": "membership_platinum",
    "channels": ["apple_wallet", "google_wallet"]
  }'

3. Entregarla

curl -X POST https://api.nomi-tech.com/v1/distributions \
  -H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
  -H "Content-Type: application/json" \
  -d '{
    "credentialId": "cred_…",
    "channel": "email",
    "wallet": "apple_wallet",
    "recipientEmail": "alex@example.com"
  }'

La respuesta trae una url. Ese enlace es la entrega: dibujado es un QR, escrito es una etiqueta NFC, dentro de un mensaje es un correo.

4. Verificarla

curl https://api.nomi-tech.com/public/credentials/AB12-CD34

Esa va sin llave. La verificación pública es la que usa un tercero, y pedirle una cuenta la dejaría sin sentido.