Para qué sirven los tokens de acceso
Un token de acceso (también llamado clave API o API key) permite que tu propio software, un desarrollador o una herramienta externa lean datos de tu tienda a través de la API de Storeep. Cada token tiene sus propios permisos, su periodo de datos y su fecha de caducidad, así que puedes dar a cada herramienta exactamente lo que necesita y retirárselo cuando quieras sin compartir tu contraseña.
Abre Ajustes > Tokens de acceso. El botón Ver documentación abre la referencia de la API, con los endpoints, cómo enviar el token y los límites de peticiones. Comparte esa página con tu desarrollador.
¿Quieres conectar un asistente de IA como Claude o ChatGPT? Eso no usa tokens de acceso. Consulta Conectar un asistente de IA.
Crear un token
Haz clic en Crear un token nuevo, rellena el formulario y haz clic en Crear.
- Nombre del token: una etiqueta para reconocerlo en tu lista, por ejemplo "Sincronización contable". Solo la ves tú.
- Permisos: marca al menos uno:
- Leer productos: listados de productos, detalles, variantes e inventario.
- Leer pedidos: historial de pedidos, detalles, estados y líneas de pedido.
- Leer webhooks: ver las configuraciones de webhooks y los registros de entregas.
- Gestionar webhooks: crear, actualizar y eliminar suscripciones de webhooks a través de la API.
- Acceso a los datos: hasta qué fecha hacia atrás puede leer el token.
- Últimas 24 horas: solo los datos creados en las últimas 24 horas. La opción más segura, buena para sincronizaciones en tiempo real.
- Establecer fecha de inicio: solo los datos creados a partir de una fecha que eliges en Fecha de inicio de acceso a los datos.
- Todo el tiempo: todos tus datos, sin límite de fecha.
- Caducidad: Nunca caduca, o Establecer fecha de caducidad para elegir una fecha de hasta un año después. Pasada esa fecha, el token deja de funcionar solo.
Copia tu token ahora
Después de hacer clic en Crear, la ventana muestra Su token de acceso con un botón de copiar. Este token solo se muestra una vez. Cópialo y guárdalo en un lugar seguro, como un gestor de contraseñas. Storeep no puede volver a mostrarlo. Si lo pierdes, elimina el token y crea uno nuevo.
Trátalo como una contraseña. Nunca lo pongas en el código de un sitio web, en repositorios públicos, en capturas de pantalla ni en mensajes de chat.
La lista de tokens
- Nombre, con la fecha en que se creó.
- Permisos: por ejemplo Lectura de productos o Lectura de pedidos.
- Acceso a los datos: Últimas 24 horas, Todos los datos o Desde una fecha.
- Caducidad: una fecha, o Nunca.
- Último uso: cuándo usó el token una herramienta por última vez, o Nunca.
Hay un número máximo de tokens por tienda. Cuando lo alcanzas, el botón Crear un token nuevo desaparece hasta que elimines uno.
Editar un token
Haz clic en un token para cambiar su nombre, sus permisos, su acceso a los datos o su caducidad. El valor del token no cambia, así que la herramienta que lo usa sigue funcionando con las nuevas reglas.
Eliminar un token
Marca uno o varios tokens y elige Eliminar tokens, o usa el botón de papelera de una fila. El token deja de funcionar al instante, y cualquier herramienta que lo use recibe un error.
Consejos
- Da a cada herramienta su propio token, para poder retirar uno sin romper los demás.
- Elige el periodo de datos más pequeño que funcione.
- Fija una fecha de caducidad para freelancers y trabajos puntuales.
- Un token que muestra Nunca en Último uso durante mucho tiempo probablemente no hace falta. Elimínalo.
- Para que Storeep envíe los eventos de pedidos a tu servidor en lugar de que tu servidor los pida, usa webhooks.