Acerca de las claves API

En este artículo, veremos qué es una API y cómo generar una clave de API para otorgar acceso a tu cuenta de Mailchimp. También explicaremos a dónde acudir si tienes preguntas sobre la API de marketing de Mailchimp.

¿Qué es una API?

API significa Interfaz de Programación de Aplicaciones. Imagina una API como la forma en la que diferentes aplicaciones se comunican entre sí. Envías y recibes datos entre aplicaciones mediante peticiones y respuestas a la API. Una clave API es una serie única de caracteres que se incluye en una solicitud para verificar que el sistema solicitante está autorizado a comunicarse con el sistema receptor.

Cómo generar una clave API

A menudo tendrás que generar una clave API cuando configures una integración con tu cuenta de Mailchimp. Los usuarios con permisos de Manager pueden generar y ver sus propias claves API. Los usuarios con permisos de administrador también pueden ver las claves API que han generado los usuarios de otras cuentas.

Para generar una clave API, sigue estos pasos:

1. Haz clic en tu icono de perfil y selecciona Account (Cuenta).
2. Haz clic en el menú desplegable Extras y selecciona Claves API.
3. En la sección Tus claves API, haz clic en Crear una clave.
4. Ponle nombre a tu clave. Haz que sea descriptivo, 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 de la clave en tu lista de claves API.
5. Haz clic en Generate Key (Generar clave).
6. 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.
7. Haz clic en Done (Hecho).

Cómo revocar una clave API

Si una clave API se ha visto comprometida o ya no utilizas la integración que accedía a tu cuenta a través de ella, puedes revocarla. Una vez que hayas revocado una clave API, no se puede reactivar. Tendrás que generar una nueva clave y actualizar todas las integraciones que utilicen la clave original.

Para revocar una clave API, sigue estos pasos:

1. Haz clic en tu icono de perfil y selecciona Account (Cuenta).
2. Haz clic en el menú desplegable Extras y selecciona Claves API.
3. Busca la clave API que quieres revocar y haz clic en Revoke (Revocar).
4. En el modal emergente, escribe REVOKE y, a continuación, haz clic en Revocar para confirmar la acción.

Seguridad de la clave API

Las claves API conceden acceso completo a tu cuenta de Mailchimp. Debes protegerlas del mismo modo en que protegerías tu contraseña. Ten en cuenta estas situaciones habituales cuando trabajes con claves API.

• Asigna a cada integración su propia clave API. Asigna nombres descriptivos a cada clave para saber qué clave va con qué 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 documentos de ayuda). Recuerda que difuminar tus datos no siempre es suficiente. Lo mejor es eliminar los datos por completo.
• Debido a los posibles riesgos de seguridad que conlleva 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 el acceso a tu cuenta, genera una nueva clave y asígnale un nombre para saber qué clave revocar, si es necesario. Nunca envíes una clave API por correo electrónico. Esto podría permitir el acceso 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, eliminaremos de tu cuenta cualquier clave API que ese usuario haya generado.
• La función del usuario que generó la clave API determina el acceso a cada punto final. 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á capacitado para resolver problemas complejos de la API. Si necesitas un desarrollador para ayudarte a configurar algo usando la API, echa un vistazo a nuestro gran Directorio de expertos. En este figuran expertos externos de Mailchimp que se pueden contratar para brindarte asistencia.

Si eres un desarrollador que desea construir su propia integración con Mailchimp, echa un vistazo a nuestra documentación API.