> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt > Use this file to discover all available pages before exploring further. # API de HubSpot | Pautas de uso > Las pautas de uso de la API de HubSpot cubren nuestra política de uso aceptable, los términos de la API, los límites de frecuencia, la autenticación y la seguridad. HubSpot monitoriza atentamente el uso de nuestras API públicas para garantizar una experiencia de calidad para cada usuario. Todos los desarrolladores de aplicaciones e integraciones deben cumplir con la [política de uso aceptable de HubSpot](https://legal.hubspot.com/es/acceptable-use) y los [Términos de la API](https://legal.hubspot.com/es/hs-developer-terms). Mientras HubSpot se reserva el derecho de cambiar o eliminar las API a lo largo del tiempo, las actualizaciones siempre se proporcionarán por adelantado a través del [registro de cambios para desarrolladores](https://developers.hubspot.com/changelog). ## Autenticación y seguridad Para maximizar la seguridad, todas las aplicaciones deben usar el [protocolo OAuth](/apps/legacy-apps/authentication/working-with-oauth) de HubSpot directamente, o el token de acceso de tu aplicación si estás creando una [aplicación privada](/apps/legacy-apps/private-apps/overview). De conformidad con este protocolo, las aplicaciones son responsables de almacenar datos del tiempo de actividad (TTL) y actualizar los tokens de acceso del usuario. Cuando se genere un token de acceso, incluirá un parámetro `expires_in` que indica cuánto tiempo se puede usar para hacer llamadas a la API antes de actualizarse. Las solicitudes `Unauthorized (401)` no son un indicador válido de que un nuevo token de acceso debe ser devuelto. ## Comprobación del uso de la API ### Aplicaciones privadas **Para ver el uso de la API en una aplicación privada:** * En tu cuenta de HubSpot, haz clic en el **ícono de configuración** de la barra de navegación principal. * En el menú de la barra lateral izquierda, ve a **Integraciones** > **Aplicaciones privadas**. * Haz clic en el **nombre** de la aplicación privada. * En la página de detalles de la aplicación, haz clic en la pestaña **Registros**. * Revisa las llamadas a la API que aparecen en la tabla. También puedes usar la **barra de búsqueda**, los **filtros** y los **selectores de fechas** para refinar aún más las llamadas a la API que se muestran. Pestaña de registro con las llamadas a la API **Consulta más información sobre cómo [comprobar el uso de la API en aplicaciones privadas](/apps/legacy-apps/private-apps/overview).** ### Aplicaciones públicas que usan OAuth Para ver el uso que hace de la API una aplicación pública mediante OAuth: * En tu cuenta de desarrollador, ve a **Aplicaciones** en la barra de navegación principal. * Haz clic en el **nombre** de la aplicación. * En el menú de la barra lateral izquierda, ve a **Monitorización**. * Usa las **pestañas** para ver los diferentes tipos de solicitudes que se realizan desde o hacia la aplicación. Mientras ves estos registros, puedes hacer clic en una **solicitud individual** para ver más información. 6-request_details Más información sobre la [monitorización del uso de la API con aplicaciones públicas](/apps/legacy-apps/public-apps/overview#monitor-app-behavior). ## Límites de frecuencia #### Aplicaciones públicas Con las aplicaciones de OAuth, cada cuenta de HubSpot que instala tu aplicación está limitada a 110 solicitudes cada 10 segundos. Esto excluye la [API de búsqueda](https://developers.hubspot.com/docs/api-reference/search/guide), como se indica en la sección [otros límites](#other-limits) que aparece abajo. No se tienen en cuenta los [aumentos del límite de la API](https://legal.hubspot.com/es/hubspot-product-and-services-catalog#Addons). #### Aplicaciones privadas El número de llamadas que la aplicación puede hacer depende del tipo de suscripción de tu cuenta y de si has adquirido el [aumento del límite de la API](https://legal.hubspot.com/es/hubspot-product-and-services-catalog#Addons): | | **Nivel del producto** | **Por 10 segundos** | **Al día** | | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | Aplicaciones privadas | (Cualquier Hub)
Gratis y Starter | 100 / aplicación privada | 250.000 / cuenta | | | (Cualquier Hub)
Pro | 190 / aplicación privada | 625.000 / cuenta | | | (Cualquier Hub)
Enterprise | 190 / aplicación privada | 1000 / cuenta | | Aplicaciones privadas con un [aumento en el límite de la API](https://legal.hubspot.com/es/hubspot-product-and-services-catalog#Addons) | (Cualquier Hub)
Edición gratuita, Starter, Pro y Enterprise | 250 / aplicación privada | 1000 / cuenta además de tu suscripción básica, por cada aumento en el límite. Puedes adquirir un máximo de dos aumentos en el límite de la API. | ### Nota: Al adquirir un aumento en el límite de la API, aumentará el número máximo de solicitudes que puedes hacer a la [API de asociaciones](/api-reference/crm-associations-v4/guide) a 1.000.000 de solicitudes diarias y a 200 solicitudes cada 10 segundos, pero estos límites no pueden aumentarse más con una compra adicional de esta funcionalidad. ## Otros límites * Puedes crear hasta 100 aplicaciones por cuenta de desarrollador. * Puedes crear hasta 20 aplicaciones privadas por cuenta de HubSpot. * Puedes crear hasta 1000 suscripciones de webhook por aplicación. * Puedes crear hasta 25 ajustes de la extensión del CRM por aplicación. * Puedes crear hasta 750 tipos de eventos de cronología por aplicación. * Puedes crear hasta 500 propiedades por tipo de evento de cronología. ## Límites de solicitudes Ten en cuenta los siguientes límites generales al hacer solicitudes a los endpoints de la API de HubSpot. Algunas API también pueden tener sus propios límites más específicos, que se enumeran en la página de referencia de la API, en *Límites*. Ejemplo de los límites de envío único * Los endpoints de la [API de búsqueda](https://developers.hubspot.com/docs/api-reference/search/guide) tienen una frecuencia limitada de cinco solicitudes por segundo por token de autenticación, y de 200 registro por solicitud de página. Más información sobre [los límites de búsqueda](https://developers.hubspot.com/docs/api-reference/search/guide#limitations). * Las solicitudes de API que estén exentas de límites diarios o secundarios no se registrarán en HubSpot. Si quieres almacenar estas solicitudes exentas, tendrás que registrarlas externamente. * Las solicitudes por lotes a endpoints de objetos del CRM están limitadas a 100 registros por solicitud. Por ejemplo, no puedes leer por lotes más de 100 contactos por solicitud. ## Límites de servicio Consulta más información sobre nuestros límites de servicio y precios en [esta página](https://legal.hubspot.com/hubspot-product-and-services-catalog). ## Respuestas de Error Cualquier aplicación o integración que supere sus límites de frecuencia recibirá una respuesta de error `429` a todas las llamadas subsiguientes a la API. Las solicitudes que resultan en una respuesta de error no deberían exceder el 5% del total de solicitudes diarias. Si planeas anunciar tu aplicación en el [mercado de aplicaciones de HubSpot](https://ecosystem.hubspot.com/marketplace/apps), debes estar bajo este límite del 5% para conseguir la certificación. La respuesta `429` tendrá el siguiente formato: ```json theme={null} //Example { "status": "error", "message": "You have reached your daily limit.", "errorType": "RATE_LIMIT", "correlationId": "c033cdaa-2c40-4a64-ae48-b4cec88dad24", "policyName": "DAILY", "requestId": "3d3e35b7-0dae-4b9f-a6e3-9c230cbcf8dd" } ``` Los parámetros `message` y `policyName` indican qué límite alcanzaste (ya sea diariamente o en segundo lugar). El límite **diario** se restablece a la medianoche según tu [zona horaria](https://knowledge.hubspot.com/account-management/change-your-language-and-region-settings). La siguiente tabla detalla los encabezados del límite de frecuencia incluidos en la respuesta de cada solicitud de la API a HubSpot, sujeto a las excepciones que se enumeran a continuación. | **Título** | **Descripción** | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `X-HubSpot-RateLimit-Daily` | La cantidad de solicitudes a la API permitidas por día. Ten en cuenta que este título no está incluido en la respuesta a las solicitudes a la API autorizadas mediante [OAuth](/apps/legacy-apps/authentication/working-with-oauth). | | `X-HubSpot-RateLimit-Daily-Remaining` | El número de solicitudes a la API que aún se permiten en el día actual. Ten en cuenta que este título no está incluido en la respuesta a las solicitudes a la API autorizadas mediante [OAuth](/apps/legacy-apps/authentication/working-with-oauth). | | `X-HubSpot-RateLimit-Interval-Milliseconds` | La ventana de tiempo a la que se aplican los encabezados `X-HubSpot-RateLimit-Max` y `X-HubSpot-RateLimit-Remaining`. Por ejemplo, un valor de 10.000 sería una ventana de 10 segundos. | | `X-HubSpot-RateLimit-Max` | El número de solicitudes permitidas en la ventana identificada en `X-HubSpot-RateLimit-Interval-Milliseconds`. Por ejemplo, si este encabezado tuviera un valor de 100 y el encabezado `X-HubSpot-RateLimit-Interval-Milliseconds` fuera 10.000, el límite aplicado sería de 100 solicitudes por 10 segundos. | | `X-HubSpot-RateLimit-Remaining` | El número de solicitudes a la API que aún se permiten en la ventana especificada en `X-HubSpot-RateLimit-Interval-Milliseconds` | ### Nota: * Los encabezados `X-HubSpot-RateLimit-Secondly` y `X-HubSpot-RateLimit-Secondly-Remaining` todavía están incluidos y aún tendrán datos precisos, pero el límite al que hacen referencia estos encabezados ya no se aplica y estos dos encabezados deben considerarse obsoletos. * Las respuestas de los [endpoints de la API de búsqueda](https://developers.hubspot.com/docs/api-reference/search/guide) no incluirán ninguno de los encabezados del límite de frecuencia enumerados arriba. También puedes comprobar el número de llamadas utilizadas durante el día actual usando [este endpoint](/api-reference/account-account-info-v3/guide). Si estás llegando al límite `TEN_SECONDLY_ROLLING`, debes limitar las solicitudes que hace tu aplicación para mantenerte por debajo de ese límite. Además de eliminar las solicitudes, o si vas a alcanzar el límite diario, echa un vistazo a las sugerencias que se incluyen abajo. Si sigues alcanzando los límites de llamadas después de analizar estas sugerencias, puedes plantear tu situación en los [foros de desarrolladores](https://integrate.hubspot.com/) de HubSpot. Debes incluir tantos detalles como sea posible sobre las API que estás usando, cómo las estás usando y qué límite estás alcanzando. ### Usa APIs por lotes y los resultados de la caché cuando sea posible Si tu sitio o aplicación usa datos de HubSpot en cada una de las páginas de carga, esa información debe estar almacenada y cargarse desde esa memoria caché en lugar de ser solicitada desde las API de HubSpot cada vez. Si haces llamadas reiteradas para obtener la configuración de tu cuenta en un trabajo por lotes (como obtener las propiedades, los propietarios o la configuración de un formulario), esa configuración también debería almacenarse en caché cuando sea posible. ### Usa webhooks para obtener datos actualizados de HubSpot Si tienes una suscripción a Marketing Hub Enterprise, puedes usar acciones de webhook en workflows para que los datos de los registros de los contactos se envíen a tu sistema. Los webhooks pueden activarse como una acción en cualquier workflow, por lo que puedes usar [condiciones de inicio](https://knowledge.hubspot.com/workflows/understand-contact-based-workflow-types) de workflow como criterios para que los datos de contacto se envíen a tu sistema. Puedes consultar más detalles sobre cómo utilizar webhooks en [este recurso](https://knowledge.hubspot.com/workflows/how-do-i-use-webhooks-with-hubspot-workflows), y datos de ejemplo de webhooks en [esta página](https://developers.hubspot.es/docs/api-reference/legacy/create-manage-workflows-v3/get-automation-v3-workflows#create-a-workflow). Las llamadas a webhooks realizadas a través de workflows no se tienen en cuenta en lo referente al límite de frecuencia de la API.