Skip to Content
Ventix by Smart BusinessManual
Administración

Crear API Keys para tu tienda en línea o tus integraciones

Genera la clave que conecta tu tienda en línea u otro sistema con Ventix, y revócala cuando ya no se use.

Plan EnterprisePara: Administrador

Una API Key es la clave con la que tu tienda en línea u otro sistema (un ERP, un CRM, una automatización) se conecta a Ventix. Se crea en Configuraciones Globales → API Keys, con Nueva API Key. Para conectar un asistente de IA, usa Conectar con una API key.

Crear una clave para tu tienda en línea

La tienda solo necesita una clave sin permisos.

  1. Abre Configuraciones Globales → API Keys y pulsa Nueva API Key.
  2. En Nombre, escribe dónde la usarás, por ejemplo «Tienda online».
  3. No marques ningún permiso. Verás Sin permisos, la clave solo servirá para la tienda online (catálogo público).
  4. Pulsa Crear API Key y sigue Guardar la clave.

En la lista, esta clave sale como Solo tienda online. Cómo se arma la tienda: Preparar la tienda en línea.

Crear una clave para otro sistema

  1. Pulsa Nueva API Key y escribe el Nombre, por ejemplo «ERP».
  2. Marca los permisos por módulo. Solo lectura marca las lecturas que no muestran costos ni datos financieros; Todos y Ninguno marcan o quitan todo.
  3. Revisa los que dicen Sensible: muestran datos delicados, como costos. Márcalos solo si ese sistema los necesita.
  4. Pulsa Crear API Key y sigue Guardar la clave.

Marca solo lo necesario. Qué deja ver cada permiso: Elegir los permisos.

Importante: los permisos no se pueden cambiar después. Si necesitas otros, crea una clave nueva y revoca la anterior.

Ventana Nueva API Key con el nombre escrito y los permisos agrupados por módulo: 1, el campo Nombre; 2, el atajo Solo lectura; 3, el aviso de que sin permisos la clave solo sirve para la tienda; 4, el botón Crear API Key.

Guardar la clave

Al crearla se abre API Key creada.

  1. Pulsa el ícono de copiar y guarda la clave en un lugar seguro.
  2. Pulsa Listo, ya la guardé.

Entrégale la clave a tu programador por un medio seguro, junto con el manual de la API pública: ahí están la URL base, el primer ejemplo y la referencia completa.

Importante: esta es la única vez que ves la clave completa. Si la pierdes, crea otra y revoca la anterior. Trátala como una contraseña: no la pegues en chats, correos ni capturas.

Ventana API Key creada con el aviso de que es la única vez que verás la clave completa, el nombre y la clave oculta en la imagen: 1, el botón de copiar; 2, el botón Listo, ya la guardé.

Leer la lista

Cada clave muestra:

  • Nombre y Clave: de la clave solo se ve el inicio y los últimos 4 caracteres.
  • Permisos: cuántos tiene, o Solo tienda online.
  • Estado: Activa o Revocada.
  • Último uso (o Nunca usada) y Creada. Estas fechas salen como mes/día/año.

Usa Buscar por nombre... si tienes muchas.

Lista de API Keys con claves de ejemplo: 1, el botón Nueva API Key; 2, la columna Permisos; 3, la columna Estado; 4, el botón de acciones de la fila. Las claves abreviadas y las fechas están ocultas en la imagen.

Revocar una clave

Hazlo cuando una clave ya no se use o creas que alguien más la conoce.

  1. En la fila de la clave, pulsa el menú de los tres puntos y elige Revocar.
  2. Confirma con Revocar. Verás API Key revocada exitosamente.

Importante: revocar es inmediato y no se puede deshacer. Lo que use esa clave deja de funcionar en ese momento. Si vas a reemplazarla, crea la nueva, cámbiala en tu tienda o sistema, y revoca la anterior al final.

Ventana de confirmación Revocar API Key, que avisa que la clave dejará de funcionar de inmediato; el 1 marca el botón Revocar.

Cuidar la clave

  • Cada clave queda ligada al usuario que la creó y actúa con las restricciones de sus roles. Si ese usuario se desactiva o se elimina, la clave deja de funcionar y tu tienda con ella. Ver Desactivar, eliminar y restaurar usuarios.
  • Usa una clave por cada tienda o sistema: así puedes revocar una sin afectar a las demás.
  • Solo el administrador ve esta pantalla.

Si algo sale mal

MensajeQué hacer
El nombre es requeridoEscribe el Nombre de la clave.
Máximo 100 caracteresAcorta el nombre.
No se pudieron cargar los permisos disponibles. Cierra este diálogo e inténtalo de nuevo.Cierra la ventana y vuelve a pulsar Nueva API Key.
Error al crear la API KeyInténtalo otra vez. Si sigue, escribe a VENTIX.
La API Key ya fue revocada.Ya estaba revocada. Recarga la lista.

Actualizado el

En esta página