Qué resuelve: te da acceso programático (vía API) a los datos de tu tienda — para conectar Structura con otro sistema propio, un ERP, o una integración a medida que tu equipo técnico necesite construir.
Cuándo conviene usarla: sólo si vos o tu equipo de desarrollo necesitan leer/escribir datos de Structura desde fuera del panel (por ejemplo, sincronizar stock con otro sistema). Si no tenés un equipo técnico, probablemente no la necesites.
Requisitos previos: conocimientos técnicos para consumir una API REST (esto es para desarrolladores, no para el uso operativo diario del comercio).
Dónde encontrarla: Configuración → API.
Configuración paso a paso:
- Andá a Configuración → API.
- Ponele un nombre descriptivo a la key (por ejemplo, "Integración ERP").
- Hacé clic en Crear key.
- Copiá el secreto que se muestra en ese momento — no se vuelve a mostrar nunca más.
Qué debe completar el comercio: el nombre de la key. El resto lo genera Structura.
Qué sucede después de guardar: la key queda activa de inmediato y puede usarse para autenticar pedidos a la API enviando el header X-Api-Key con el secreto completo (el panel sólo vuelve a mostrar el prefijo, no el secreto completo).
Cómo verificar que quedó funcionando: hacé una petición de prueba a la API con el header X-Api-Key — el enlace Ver documentación de la API dentro de la misma pantalla te lleva al detalle de endpoints disponibles.
Errores frecuentes:
- Perder el secreto sin copiarlo: no hay forma de recuperarlo, hay que revocar esa key y crear una nueva.
- Compartir el secreto por canales inseguros (chat, email sin cifrar) — tratalo como una contraseña.
Límites o plan: disponible desde plan Business.
Cómo desactivar o cambiar: para revocar el acceso de una key, hacé clic en el ícono de basura en la fila correspondiente — la revocación es inmediata y no se puede deshacer. No hay edición de una key existente: si necesitás cambiar algo, revocá y creá una nueva.
Preguntas frecuentes:
- *¿Cuántas keys puedo crear?* No hay un límite fijo documentado en el panel; creá una por cada integración distinta para poder revocarlas de forma independiente.
- *¿Qué permisos tiene una key nueva?* Se crea con permiso de lectura por defecto.