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

URL: https://ventix.smartbusiness.site/manual/administracion/api-keys-para-tu-tienda

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](https://ventix.smartbusiness.site/manual/asistentes-de-ia/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](#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](https://ventix.smartbusiness.site/manual/tienda-en-linea/preparar-la-tienda-en-linea).

## 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](#guardar-la-clave).

Marca solo lo necesario. Qué deja ver cada permiso: [Elegir los permisos](https://ventix.smartbusiness.site/manual/asistentes-de-ia/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.](https://ventix.smartbusiness.site/manual/capturas/administracion/api-keys-para-tu-tienda/nueva.webp)

## 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](https://ventix.smartbusiness.site/manual/api): 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é.](https://ventix.smartbusiness.site/manual/capturas/administracion/api-keys-para-tu-tienda/creada.webp)

## 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.](https://ventix.smartbusiness.site/manual/capturas/administracion/api-keys-para-tu-tienda/lista.webp)

## 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.](https://ventix.smartbusiness.site/manual/capturas/administracion/api-keys-para-tu-tienda/revocar.webp)

## 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](https://ventix.smartbusiness.site/manual/administracion/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

| Mensaje | Qué hacer |
| --- | --- |
| El nombre es requerido | Escribe el **Nombre** de la clave. |
| Máximo 100 caracteres | Acorta 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 Key | Inténtalo otra vez. Si sigue, escribe a VENTIX. |
| La API Key ya fue revocada. | Ya estaba revocada. Recarga la lista. |