Última actualización: junio 28, 2023
Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:
Todos los productos y planes
|
Con la clave de API de HubSpot, los desarrolladores pueden crear aplicaciones personalizadas con las API de HubSpot. Cada clave es específica de una cuenta de HubSpot, no de un usuario individual, y solo se admite una clave por vez.
Nota: desde el 30 de noviembre de 2022, las claves de API de HubSpot están obsoletas y ya no son compatibles. En cambio, deberás usar un token de acceso a aplicaciones privadas o utilizar OAuth para autenticar. Más información sobre este cambio y cómo migrar una integración de claves de API para usar una aplicación privada en su lugar.
Si estás viendo un banner en tu cuenta sobre la desactivación de tu clave API:
- Asegúrate de que has migrado todas las integraciones afectadas y luego desactiva la clave de API en.
- Para comprobar si la clave API de la cuenta se ha utilizado en los últimos siete días, puedes ver tu historial de llamadas de la clave de API. El registro de llamadas no mostrará ninguna solicitud realizada con la clave hace más de siete días.
- Las aplicaciones que aparecen en la página Aplicaciones conectadas de la configuración de tu cuenta no necesitan migrarse, ya que se autentican con OAuth.
- Las claves de la API para desarrolladores son independientes de las claves de la API estándar de HubSpot y no están obsoletas. Las claves de la API para desarrolladores se utilizan para gestionar los ajustes relacionados con tus aplicaciones de HubSpot, incluyendo suscripciones de API de webhooks y tipos de eventos de API de eventos de la cronología.
Acceder a tu clave API
Debes tener permisos de superadministrador para acceder a la clave de API de tu cuenta.
- En tu cuenta de HubSpot, haz clic en el icono de Configuración en la barra de navegación superior.
- En el menú de la barra lateral izquierda, navega a Integraciones > Clave API.
- Si nunca se generó una clave para tu cuenta, haz clic en Generar clave API.
- Si ya generaste una clave API, haz clic en Mostrar para mostrar tu clave.
- Con la clave que se muestra, haz clic en Copiar para copiar la clave. Luego, puedes pegar la clave para proporcionarla a los desarrolladores o usarla en las aplicaciones.
Rota tu clave API
Ofrecer tu clave de API a un desarrollador le dará acceso completo para hacer cambios en tu cuenta a través de la API de HubSpot, lo que incluye leer correos electrónicos registrados de cuentas de correo electrónico conectadas y otros datos de terceros.
Para tener más seguridad, considera rotar tu clave de API de HubSpot cada seis meses. Rotar tu clave API de HubSpot requiere desactivar la clave API existente y generar una nueva. HubSpot mostrará la edad de la clave API y recomendará cuándo deberías rotar tu clave API.
Las notificaciones por correo electrónico se envían cada 180 días a súper administradores y usuarios que crearon o rotaron la clave API si la clave API no se ha rotado en ese período de tiempo.
Si bien esto puede crear tiempo de inactividad y requerir esfuerzo, agrega una capa de seguridad al evitar que aplicaciones maliciosas accedan a tu información de HubSpot con tu clave de API actual.
Para rotar tu clave de API de HubSpot:
- En tu cuenta de HubSpot, haz clic en el ícono de configuración en la barra de navegación principal.
- En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
- Haz clic en el menú desplegable Acciones, y luego selecciona Rotar clave.
- Haz clic en Rotar y caducar esta clave ahora. Selecciona la casilla de comprobación reCAPTCHA. Tu clave actual se desactivará y se creará una nueva clave de API.
- Haz clic en Copiar y reemplaza la clave de API desactivada utilizada por tus aplicaciones con esta nueva clave de API.
Cualquier llamada de API que use esta clave de API de HubSpot desactivada ahora fallará y cualquier aplicación que utilice esta clave ya no podrá acceder a tu información.
Rotar tu clave de API no afectará tu conexión con la integración de Salesforce. Sin embargo, si tienes una integración personalizada instalada, deberás actualizar tu clave API después de que la rotes.
Nota: las aplicaciones conectadas instaladas a través del Mercado de aplicaciones no se verán afectadas cuando rotes tu clave de API.
Desactiva tu clave de API
Desactivar tu clave de API no creará una nueva clave. Las llamadas de API que usen la clave de API de HubSpot desactivada fallarán, y cualquier aplicación que utilice esta clave ya no podrá acceder a tu información.
Para desactivar tu clave de API:- En tu cuenta de HubSpot, haz clic en el icono de Configuración en la barra de navegación superior.
- En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
- Haz clic en el menú desplegable Acciones.
- Haz clic en Desactivar clave, y haz clic en Desactivar esta clave ahora. Selecciona la casilla de comprobación reCAPTCHA.
Ve tu registro de auditoría de API
Puedes ver un registro fechado de usuarios que han visto, creado o desactivado la clave API de la cuenta en la sección Registro de auditoría.
- En tu cuenta de HubSpot, haz clic en el icono de Configuración en la barra de navegación superior.
- En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
- Haz clic en la pestaña Registro de auditoría.
Ver tu registro de llamada de clave API
Para ayudarte a depurar una de tus integraciones o para asegurarte de cumplir con las pautas de uso de la API de HubSpot, puedes ver un registro de las llamadas de tu clave de API de los 7 días anteriores.
- En tu cuenta de HubSpot, haz clic en el icono de Configuración en la barra de navegación superior.
- En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
- En la pestaña Registro de llamadas, ve toda la actividad de los últimos 7 días.
