Cómo administrar las claves de API de tu cuenta
Los Propietarios, Administradores y Gerentes pueden acceder a la pestaña Claves de API.
Descubre cómo acceder y gestionar las claves de API de tu cuenta de Klaviyo.
Si quieres aprender a crear o clonar una clave de API privada, lee cómo crear claves de API privadas.
Diferencias entre las claves de API públicas y privadas
Tu clave de API pública también se conoce como ID del sitio. Es un valor alfanumérico corto. Esta clave pública es el identificador único de la cuenta de Klaviyo y solo hay 1 por cuenta. Puedes incluir tu clave de API pública en el código del sitio web. No otorga permiso para leer datos privados de la cuenta.
Las claves de API privadas permiten que las aplicaciones lean o cambien datos en tu cuenta de Klaviyo, como las listas, según los permisos (alcances) que selecciones. Trata las claves de API privadas como si fueran contraseñas: guárdalas en un lugar seguro y nunca las expongas al público. Una cuenta de Klaviyo puede generar tantas claves de API privadas como sean necesarias.
Qué hacer si se expone tu clave de API
La clave de API pública está pensada para usarse en el código de sitios web públicos. No permite que alguien lea los datos privados de la cuenta, pero puede usarse para enviar datos a través de las interfaces de programación de aplicaciones (API) del cliente, como eventos y actualizaciones de perfil.
Mantén la clave de API privada de forma confidencial. Alguien con una clave privada puede usar sus permisos para ver o editar los datos de los clientes.
Si se expone una clave de API privada, elimínala de inmediato y luego crea una nueva clave de API privada. Actualiza cada aplicación que haya usado la clave expuesta para que use la nueva clave. Otorga a la clave de reemplazo solo los permisos que necesita la aplicación y usa una clave de API privada diferente para cada aplicación.
Cómo encontrar tus claves de API
Copia o descarga una clave de API privada cuando la crees, antes de salir de la página de confirmación. No puedes volver a ver la clave completa más adelante. Guárdala de forma segura, por ejemplo, en una bóveda o un administrador de contraseñas, y compártela solo con personas o entidades en las que confíes. Si no guardaste la clave, crea una clave nueva o clona la existente.
- Haz clic en el nombre de tu cuenta en la parte inferior izquierda.
- Haz clic en Configuración.
- Selecciona la pestaña claves de API .
- Ver la clave de API pública (ID del sitio).
- En Claves de API privadas, revisa los nombres de las claves y los niveles de acceso. Puedes identificar una clave por sus últimos 4 caracteres, pero aquí no puedes ver ni copiar la clave completa.
Si una clave no está en la pestaña con actividad, revisa sin actividad o Deshabilitada si esas pestañas se muestran.
Cómo clonar una clave de API privada
Cuando clonas claves de API privadas existentes, la clave clonada:
- Será totalmente distinta de la clave original.
- Usa el mismo nombre que el original.
- Tener los mismos alcances que el original, excepto los alcances obsoletos que ya no son compatibles.
La clonación deja la clave original intacta. Copia o descarga la clave clonada y guárdala de forma segura. Para usarla en una aplicación, actualiza la configuración de esa aplicación con la nueva clave. Elimina la clave original cuando ya no sea necesaria.
Eliminar una clave de API privada
Eliminar una clave de API privada no se puede deshacer. Las solicitudes de interfaz de programación de aplicaciones (API) que la utilicen dejarán de funcionar. Si vas a reemplazar una clave que no se ha expuesto, actualiza y prueba las aplicaciones que la usan antes de eliminarla. Si la clave queda expuesta, elimínala de inmediato.
- Abre la pestaña Claves de API con los pasos anteriores. En Claves de API privadas, busca la clave que quieres eliminar.
- Abre el menú de 3 puntos junto a la clave y selecciona Eliminar.
- Haz clic en Eliminar en el cuadro de diálogo de confirmación.
Recursos adicionales
- How to create or clone a private API key
Learn how to create a private API key, which is a unique identifier used for API calls, as well as define a scope.
- Understanding how information is exchanged between Klaviyo and apps
Learn about how information syncs between Klaviyo and your third-party apps via an application programming interface (API). Most data exchanged via a Klaviyo integration is one-way: data is pulled into your Klaviyo account so you can leverage a broad scope of your customer's data.
- Klaviyo's API reference guide