Cómo gestionar las claves de API de tu cuenta
Los propietarios, los administradores y los gestores pueden acceder a la pestaña de claves de API.
Descubre cómo gestionar y acceder a tus claves de API para tu cuenta de Klaviyo.
Si quieres obtener información sobre cómo crear o clonar una clave de API privada, consulta 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 denomina ID del sitio. Se trata de un valor alfanumérico corto. Esta clave pública es un identificador único de tu cuenta de Klaviyo y solo hay 1 por cuenta. Puedes incluir la clave de API pública en el código del sitio web. No concede permiso para leer los datos privados de la cuenta.
Las claves de API privadas permiten que las aplicaciones lean o modifiquen datos en tu cuenta de Klaviyo, como listas, según los permisos (ámbitos) 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 sea necesario.
Qué hacer si tu clave de API queda expuesta
La clave de API pública está pensada para usarse en código público de sitios web. No permite que alguien lea datos privados de la cuenta, pero se puede usar para enviar datos a través de las API de cliente, como eventos y actualizaciones de perfiles.
Mantén las claves de API privadas y confidenciales. Una persona 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 inmediatamente y, a continuación, crea una nueva clave de API privada. Actualiza cada aplicación que utilizó la clave expuesta para que use la nueva clave. Concede a la clave de sustitución solo los permisos que necesita la aplicación y usa una clave de API privada diferente para cada aplicación.
Acceso a las claves de API
Copia o descarga una clave de API privada al crearla, 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 caja fuerte o en un administrador de contraseñas) y compártela solo con las partes en las que confíes. Si no has guardado 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 clave de API .
- Consulta tu clave de API pública (ID del sitio).
- En Claves privadas de API, 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 Activa, comprueba Inactiva o Deshabilitada si se muestran esas pestañas.
Clonar claves de API privadas
Cuando clonas claves de API privadas existentes, la clave clonada:
- Será una clave totalmente diferente de la original.
- Usa el mismo nombre que el original.
- Tienen los mismos ámbitos que el original, excepto los ámbitos obsoletos que ya no son compatibles.
La clonación deja la clave original en su lugar. Copia o descarga la clave clonada y guárdala en un lugar seguro. 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 es una acción que no se puede deshacer. Las solicitudes de API que lo usen dejarán de funcionar. Si vas a sustituir una clave que no se ha expuesto, actualiza y prueba las aplicaciones que la usan antes de eliminarla. Si la clave está expuesta, elimínala inmediatamente.
- Abre la pestaña claves de API siguiendo los pasos anteriores. En Claves de API privadas, busca la clave que quieras eliminar.
- Abre el menú de tres puntos junto a la clave y selecciona Borrar.
- 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