¿Cómo género una clave API de ventic?
La integración con la plataforma ventic requiere una clave API para autenticar las solicitudes. Estas claves son exclusivas de tu organización y proporcionan acceso seguro a tu catálogo de productos y servicios comerciales.
He aquí cómo gestionar tus claves API.
1. Acceder al panel de control para desarrolladores
Inicia sesión en tu cuenta de ventic y navega a la sección Configuración > Desarrolladores (Settings > Developers). Allí encontrarás la pestaña de "Claves API" (API Keys).
2. Generar una nueva clave
Para crear una nueva clave:
- Haz clic en el botón "Crear clave API" (Create API Key).
- Dale a la clave un nombre descriptivo (por ejemplo, "Producción - Tienda Principal" o "Pruebas - Juan Pérez").
- Elige los alcances de los permisos (Scopes). Recomendamos otorgar a las claves solo los permisos necesarios (principio de mínimo privilegio).
- Haz clic en "Generar".
3. Almacenamiento seguro de la clave
Una vez generada, la clave se te presentará una sola vez.
- Importante: Copia la clave y guárdala en un lugar seguro (por ejemplo, en un gestor de contraseñas o en un almacén de claves seguro en tu infraestructura).
- Nota: Por motivos de seguridad, ventic no vuelve a mostrar la clave completa después de cerrar la ventana.
4. Uso de la clave en las solicitudes
Todas las solicitudes a la API de ventic deben incluir la clave API en el encabezado HTTP X-API-Key.
Ejemplo de uso en cURL:
curl -X GET "https://api.ventic.ai/v1/products" \
-H "X-API-Key: tu_clave_api_aqui" \
-H "Accept: application/json"
5. Rotación y eliminación de claves
Si sospechas que una clave ha sido comprometida, debes invalidarla inmediatamente.
- En el panel, selecciona la clave que deseas eliminar y haz clic en "Revocar" (Revoke).
- Una vez revocada, cualquier solicitud que utilice esa clave será rechazada.
- Genera una nueva clave y actualiza tu configuración.
Mejores prácticas de seguridad
- Nunca publiques claves API en el código fuente (por ejemplo, en GitHub). Utiliza variables de entorno.
- Utiliza claves independientes para los entornos de prueba y producción.
- Revisa periódicamente la lista de claves activas y elimina las que ya no necesites.
Si necesitas ayuda con la integración, ponte en contacto con nuestro equipo técnico en support@ventic.ai.