La clave de la cuenta
Dónde se emite, qué hacer cuando se pierde, y la diferencia entre revocar y eliminar.
La clave de API es lo que conecta una tienda a su cuenta. Es con ella con lo que el módulo se presenta y recibe de vuelta la identidad de la tienda, los motores de búsqueda y la clave pública que el panel de búsqueda usa en el navegador.
La cuenta nace sin ninguna
Y es a propósito. Una clave solo existe entera en el instante en que se emite: guardamos lo suficiente para reconocerla, nunca el valor completo. Una clave creada en el registro llegaría al panel ya ilegible, y nadie conseguiría copiarla.
Emitir
En Perfil de la tienda → Integraciones, el botón de emitir solo pide un nombre. Dale uno que diga desde dónde se va a usar, tienda-produccion o staging, porque es lo que va a leer dentro de seis meses cuando tengas tres.
El valor completo (bk_live_…) aparece una sola vez, justo después de crearla. Cópialo en ese momento y pégalo en el módulo. La lista muestra después solo el prefijo y la fecha del último uso.
Atención Nadie puede volver a mostrarte una clave, nosotros incluidos. Si la pierdes antes de pegarla, el camino es emitir otra.
Revocar, reactivar, eliminar
Cada clave de la lista tiene tres destinos, y las consecuencias no son las mismas:
- Revocar corta al momento todo lo que la estuviera usando. La tienda deja de indexar y la búsqueda deja de responder por ella.
- Reactivar deshace la revocación, con el mismo valor de antes. Es el botón de al lado, y es la razón por la que revocar es la primera reacción sensata ante una sospecha: para todo y no obliga a tocar el módulo.
- Eliminar no tiene vuelta atrás, porque el valor no está guardado en ningún sitio. Si eliminas la clave que usa la tienda, tiene que emitir otra y volver a pegarla en el módulo.
Cuándo debo cambiarla
- Alguien que tenía acceso al back-office de la tienda se ha ido del equipo.
- La clave ha pasado por un canal que no controlas (un correo reenviado, un ticket de un proveedor, una captura de pantalla).
- Está montando un entorno de preproducción: dale una clave propia, para poder revocarla por separado.
El camino es siempre el mismo: emitir la nueva, pegarla en el módulo, confirmar que la tienda sigue indexando, y solo después revocar la antigua. En este orden no hay ni un minuto de tienda parada.
Lo que la clave no es
La clave de API es del servidor de la tienda y no del navegador. El panel de búsqueda que corre en las páginas usa una clave pública de búsqueda, distinta, que el handshake entrega al módulo y que solo sirve para leer resultados. Una nunca sustituye a la otra, y la de API no debe aparecer en ningún código que llegue al visitante.