- 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 a Integraciones > Aplicaciones privadas.
- Haz clic en Crear página privada.
- En la ficha Información básica, configura los detalles de tu aplicación:
- Introduce el Nombre de tu aplicación.
- Coloca el cursor sobre el logotipo del parámetro de sustitución y haz clic en cargar icono para cargar una imagen cuadrada que funcionará como logotipo de tu aplicación.
- Introduce una descripción para tu aplicación.
- Haz clic en la pestaña Alcances.
- Selecciona la casilla de comprobación Lectura o Escritura para cada uno de los alcances a los que deseas que tu aplicación pueda acceder. También puedes buscar un alcance específico usando la barra de búsqueda Buscar un alcance.
- Después de configurar tu aplicación, haz clic en Crear aplicación en la parte superior derecha.
- En el cuadro de diálogo, revisa el contenido y haz clic en Enviar enlace.
Una vez hayas creado tu aplicación, puedes comenzar a hacer llamadas de API usando el token de acceso de la aplicación. Si necesitas editar la información de tu aplicación o cambiar sus alcances, haz clic en Editar detalles.
Para hacer llamadas de API, navega a la página de detalles de tu aplicación.
- En la tarjeta de token Acceso, haz clic en Mostrar token para revelar tu token de acceso. Haz clic en Copiar para copiar el token en tu portapapeles.
- A continuación, podrás pegar el token de acceso para suministrarlo a tus desarrolladores o para usarlo en el desarrollo de tu aplicación. Al hacer una llamada a uno de los puntos finales de la API de HubSpot, establece el valor del campo Autorización en Bearer [YOUR_TOKEN]. Por ejemplo, si estás llamando a la API de contactos usando Node.js y axios, la solicitud será similar a lo siguiente:
Si tu token de acceso se pierde o está en riesgo, puedes rotar el token. Se creará un token de acceso nuevo y el token de acceso original se vencerá.
- En tu cuenta de HubSpot, haz clic en Configuración en la barra de navegación principal.
- Navega a Integraciones > Aplicaciones privadas.
- Haz clic en el nombre de tu aplicación privada.
- Haz clic en Rotar, junto al token de acceso:
- Si tu token está en riesgo y deseas revocar el acceso inmediatamente, haz clic en Rotar y vencimiento ahora:
- Recomendamos que rotes tu token cada seis meses, incluso sin que haya amenazas al token. Si estás listo para comenzar una rotación periódica de tu token, haz clic en Rotar y vencimiento más tarde, lo que activará el vencimiento del token en 7 días.
- Si la aplicación está lista para realizar la transición antes, haz clic en Vencimiento ahora:
- Si decides que necesitas más tiempo, haz clic en Cancelar rotación, lo que cancelará el vencimiento del token original y revocará el nuevo token de acceso:
HubSpot también enviará notificaciones por correo electrónico a los superadministradores con recordatorios sobre el estado de rotación del token de acceso, así como otras alertas relacionadas. Los superadministradores de tu cuenta de HubSpot recibirán notificaciones de los siguientes eventos y recordatorios:
- Un superadministrador inició una rotación (ya sea inmediatamente o programada para dentro de 7 días).
- Un superadministrador canceló una rotación pendiente.
- Un superadministrador optó por hacer que un token de acceso venciera inmediatamente haciendo clic en Hacer que venza ahora en lugar de esperar 7 días para que venza el token.
- El token de acceso de la aplicación está a punto de vencer en 24 horas.
- El token de acceso de la aplicación ha rotado y vencido después de 7 días.
- Si no has rotado tu token de acceso en más de 180 días, los superadministradores también recibirán un correo electrónico de recordatorio para rotar el token de acceso de tu aplicación.
Para revisar las llamadas de API que realizó tu aplicación durante los últimos 30 días:
- En la página de detalles de tu aplicación, haz clic en la ficha Registros.
- Revisa y filtra las llamadas de API de tu aplicación privada:
- Haz clic en los menús desplegables Método y Respuesta para filtrar el historial de llamadas de API por método de solicitud o código de respuesta.
- Haz clic en los menús desplegables fecha de inicio o fecha final para limitar los registros de llamada a un intervalo de tiempo específico.
- También puedes buscar llamadas específicas por URL en el cuadro de búsqueda Buscar por URL.
- Para exportar los registros de llamadas de API, haz clic en Exportar registros (CSV). A continuación, especifica un intervalo de fechas (hasta los últimos 30 días) y haz clic en Exportar.
- En la casilla emergente, selecciona el rango de fechas de las llamadas a la API que deseas exportar y haz clic en Exportar. Recibirás un correo electrónico con un enlace de descarga cuando haya finalizado la exportación.