Crear la llave
La credencial con la que tu sistema entra en la API.
Cada sistema que habla con la API lleva su propia llave: así se sabe qué hizo cada uno y se puede cortar uno sin tocar los demás. La crea un administrador de la organización que pueda gestionar roles, y la API tiene que estar en el plan.
- En Nodexia, abre Configuración › Conectores › Llaves de API y pulsa «Nueva llave».
- Ponle un nombre que diga qué sistema la usa («ERP», «Web») y elige la empresa: todo lo que lea y escriba será de esa empresa y de lo compartido.
- Elige el responsable: recibe lo que la llave no sabe a quién dar, como una tarea sobre un contacto sin responsable.
- Marca sus permisos de API, los justos para lo que va a hacer (abajo, cuál pide cada cosa).
- Si tu sistema sale siempre por las mismas IP, escríbelas en «IP permitidas» (una IP o una red por línea): con el secreto robado, nadie podrá usarla desde otro sitio.
- Si la integración tiene fecha de fin, ponle caducidad: ese día deja de valer sola.
- Pulsa «Crear» y copia el secreto. Solo se enseña esa vez.
Cada operación pide un permiso de API, y la referencia dice cuál. Sin él, la respuesta es 403 forbidden y error.permission dice cuál falta. Registrar llamadas y tareas es un permiso aparte de ver contactos: una llave que solo busca no escribe nada.
- «Ver contactos»: Buscar contactos, leer su ficha y el vocabulario de tipos.
- «Ver contexto comercial»: Oportunidades abiertas, lo último que se habló y las tareas pendientes, con el nombre del contacto y quién del equipo lleva cada cosa.
- «Dar de alta contactos»: Crear fichas nuevas.
- «Registrar llamadas y tareas»: Dejar llamadas en el histórico y crear tareas de seguimiento.
- «Ver dirección»: La dirección postal del contacto, cuando la API la devuelva.
- «Ver campos propios»: Los campos que tu organización ha añadido, en el resumen del contacto.
El secreto va en tu servidor, como cualquier otra credencial. Nunca en una página web, en una app del móvil ni en el código que se publica.
export NDX_LLAVE="ndx_live_<prefijo>_<secreto>"Una llave empieza por ndx_live_ en producción y por ndx_test_ en el entorno de pruebas, y una no vale en el otro. Los últimos seis caracteres son una suma de control: una llave mal copiada se rechaza con 401 antes de mirar nada.
Si se pierde o se filtra, rótalo desde la misma pantalla. Con «Rotar secreto», el anterior sigue valiendo 24 horas para cambiarlo sin cortes; con «Rotar e invalidar ya», deja de valer en el momento. Cada petición de la llave queda en su actividad.
Una llave que no se usa en 90 días se desactiva sola, con un aviso a los 75 a su responsable y a quien la creó. Para volver a usarla, rótala.