Acerca de las claves API

En este artículo, vamos a explicar qué es una API, cómo utilizar una clave API para conceder acceso a tu cuenta de Mailchimp, y dónde acudir para obtener soporte con cualquier pregunta adicional que puedas tener sobre la Mailchimp Marketing API.

¿Qué es una API?

API significa interfaz de programación de aplicaciones. Puede ser útil pensar en la API como una forma de comunicación entre diferentes aplicaciones. Para muchos usuarios, la interacción principal con la API será a través de las claves API, que les permiten a otras aplicaciones acceder a tu cuenta sin tener que revelar la contraseña.

Cómo generar una clave API

Si deseas configurar una integración en tu cuenta de Mailchimp, es muy probable que necesites generar una clave API. Los usuarios con permisos de Manager pueden generar y ver sus propias claves API. Los usuarios con permisos de administrador también pueden ver qué claves API han generado los usuarios de otras cuentas.

Para generar una clave API, sigue estos pasos:

1. Ve a la sección Claves API de tu cuenta.
2. Haz clic en Create New Journey (Crear nuevo recorrido).
3. Dale un nombre descriptivo a la clave, de modo que sepas qué aplicación es la que utiliza dicha clave. Ten en cuenta que solo verás este nombre y los primeros 4 dígitos en tu lista de claves API una vez generada la clave.
4. Haz clic en Generate Key (Generar clave).
5. Una vez que generemos tu clave, haz clic en Copy Key to Clipboard (Copiar clave en el portapapeles). Guarda tu clave en un lugar seguro; no podrás volver a verla ni copiarla. Si pierdes esta clave, tendrás que generar una nueva y actualizar cualquier integración que la utilice.
6. Haz clic en Done (Hecho).

Cómo revocar una clave API

Si te preocupa que una clave API se haya visto comprometida o ya no utilizas la integración que accedía a tu cuenta a través de una clave API determinada, puedes revocarla. Una vez que hayas revocado una clave API, no se puede reactivar. Tendrás que generar una nueva clave y actualizar con ella cualquier integración.

Para revocar una clave API, sigue estos pasos:

1. Ve a la sección API Keys (Claves API) de tu cuenta.
2. Busca la clave API que quieres revocar y haz clic en Revoke (Revocar).
3. En el modal emergente, escribe REVOKE y, a continuación, haz clic en Revoke (Revocar) para confirmar.

Seguridad de la clave API

Las claves API conceden acceso completo a tu cuenta de Mailchimp y deben protegerse del mismo modo que protegerías tu contraseña. En particular, hay algunos escenarios comunes que debes tener en cuenta cuando trabajes con claves API.

• Da a cada integración su propia clave API y asigna etiquetas a cada una de ellas para que sepas qué clave corresponde a cada aplicación. Si se ve comprometida una determinada clave API, puedes revocar esa clave sin desactivar el acceso al resto de integraciones.
• Ten cuidado de no exponer la clave al público (como en capturas de pantalla, vídeos o documentación de ayuda). Recuerda que difuminar tus datos no siempre es suficiente. Lo mejor es utilizar funciones de "corte" en tu programa gráfico para eliminar los datos por completo.
• Debido a los posibles riesgos de seguridad asociados con la exposición de las claves API de la cuenta, Mailchimp no admite la implementación del lado del cliente de nuestra API mediante solicitudes CORS ni la inclusión de claves API en aplicaciones móviles.
• Si necesitas compartir una clave, genera una nueva y etiquétala adecuadamente para poder deshabilitarla en caso necesario. Nunca envíes una clave API por correo electrónico, ya que podrían acceder a tu cuenta de Mailchimp en caso de que tu cuenta de correo electrónico fuera vulnerada por piratas informáticos.
• Si revocas el acceso de un usuario a tu cuenta de Mailchimp, se eliminarán las claves API de tu cuenta que hayan sido creadas por el usuario.
• El acceso a punto final lo determina la función del usuario que generó la clave API. Para conocer mejor los permisos de nivel de usuario, visita Cómo administrar los niveles de usuario de tu cuenta.

Soporte de API

Nuestro equipo de soporte de Mailchimp no está preparado para resolver problemas de API a un nivel más profundo. Si necesitas un desarrollador para ayudarte a configurar algo usando la API, echa un vistazo a nuestro gran directorio de expertos, donde figuran expertos externos de Mailchimp que se pueden contratar para brindarle soporte.

Si eres un desarrollador que quieres construir tu propia integración con Mailchimp, consulta nuestra documentación de API.