Introducción

Qué cubre esta documentación, para quién está escrita y por dónde empezar.

Nomi es infraestructura de credenciales. Una organización define una credencial una vez, se la emite a una persona, y Nomi la mantiene al día con los propios registros de esa organización mientras esté vigente — incluida la copia que quedó en el teléfono.

Esta documentación está escrita para quien conecta Nomi con algo: desarrolladores, integradores, equipos de TI y administradores de plataforma en universidades, empresas y empleadores. Da por hecho que puedes hacer una solicitud HTTP y que el sistema donde viven tus miembros, tu personal o tus estudiantes es el que quieres seguir teniendo como fuente de verdad.

Qué hay aquí

• Conceptos — los seis objetos de los que está hecha la plataforma, y cómo se relacionan.
• Credenciales — crear, emitir, actualizar, revocar y verificar, con las solicitudes y respuestas reales.
• Distribución — cómo llega una credencial a una persona: Apple Wallet, Google Wallet, un enlace, un QR o un correo.
• API — la referencia de cada familia de endpoints, más autenticación y errores.
• Integraciones — los conectores que existen hoy, y los que no.
• Seguridad — llaves, firma de webhooks, protección de datos y las prácticas que sostienen una integración.

Convenciones

Todos los ejemplos corren contra https://api.nomi-tech.com. Nada de lo que aparece en estas páginas es un valor real. Llaves, identificadores, nombres, direcciones y anfitriones son marcadores sobre dominios reservados —nomi_sk_live_EXAMPLE para una llave, cred_… y sub_… para identificadores, alex@example.com para una persona, https://your-app.example para tu propio servicio— y ninguno funciona contra nada. Lo que esté marcado como Próximamente no existe todavía y no se puede planear contra ello.