Crear una clave de API y elegir sus permisos
Cómo crear una clave para tu web o tu programa de gestión, qué permite cada permiso y cómo revocarla.
Antes de empezar
- La API pública es un servicio adicional: actívalo en el plan y servicios de la tienda.
- Hace falta el permiso «Crear y revocar claves de API». El propietario lo tiene siempre.
Crear la clave
- Ve a Configuración › Productos y datos › API y desarrolladores.
- Pulsa Nueva clave y ponle un nombre que diga para qué es (por ejemplo, «Web de la tienda»).
- Marca solo los permisos que necesite la integración.
- Si la integración llama siempre desde las mismas máquinas, escribe sus IPs o redes (por ejemplo
203.0.113.0/24). Vacío = desde cualquier IP. - Si es para una prueba, pon una fecha de caducidad.
- Pulsa Crear clave y después Copiar. La clave entera solo se enseña esta vez: guárdala en un sitio seguro.
Qué permite cada permiso
products:read: productos, variantes y precios.stock:read: existencias vendibles y unidades por almacén.customers:readycustomers:write: ver clientes; crearlos y modificarlos.orders:readyorders:write: ver pedidos con sus documentos; crear pedidos, que quedan aparcados para que los confirmes.documents:read: facturas, tickets, rectificativas y albaranes con su PDF.
Una clave nunca puede más que la persona que la creó: si a esa persona le quitas un permiso, la clave también lo pierde.
Revocar
Pulsa Revocar junto a la clave. Deja de funcionar al momento y no se puede reactivar: crea otra si la necesitas. Crear y revocar claves queda en el registro de auditoría y en Operaciones sensibles. Puedes tener hasta 10 claves activas por tienda.