Documentación de referencia de la API de HubSpot

La plataforma de desarrolladores de HubSpot es una parte central de nuestra misión para empoderar a las organizaciones para que puedan crecer mejor. Las API están diseñadas para habilitar equipos de cualquier forma o tamaño para crear integraciones sólidas que los ayuden a personalizar y obtener el mayor valor de HubSpot.

Todas las API de HubSpot se crean usando las convenciones de REST y están diseñadas para tener una estructura de URLs predecible. Utilizan muchas características HTTP estándar, incluyendo métodos (POST, GET, PUT, DELETE) y códigos de error de respuesta. Todas las llamadas a la API de HubSpot se realizan en https://api.hubapi.com y todas las respuestas devuelven elementos JSON estándar.

Configuración

Existen varias maneras de crear integraciones con HubSpot:

• Para crear una integración interna para una cuenta individual de HubSpot (por ejemplo, quieres crear una aplicación que pueda acceder y editar solo partes autorizadas de tu cuenta para compartir o integrar con otras partes de tu organización), crea una aplicación privada.
• Si quieres crear una aplicación pública que se pueda instalar en varias cuentas de HubSpot, debes crear una cuenta de desarrollador. Existen varias razones para esto: una cuenta de desarrollador es donde creas aplicaciones de HubSpot, cada una autenticada con OAuth y con un conjunto de características y permisos configurables. También puedes usar tu cuenta de desarrollador para crear cuentas de prueba, monitorear el estado y el rendimiento de la aplicación o publicar aplicaciones en el Mercado de aplicaciones de HubSpot.

Más información sobre los diferentes tipos de aplicaciones y tipos de cuenta en este artículo.

Biblioteca de clientes

Las bibliotecas de clientes están diseñadas para interactuar con las API de HubSpot con menos interferencias. Están escritas en distintos lenguajes y ayudan a cerrar la brecha entre la aplicación y las API de HubSpot. Eliminan la necesidad de conocer la URL y el método HTTP exactos que se deben usar para cada llamada de API entre otras cosas, de manera que puedas tener más tiempo para concentrarte en realizar tu aplicación. Más información sobre nuestras bibliotecas de clientes aquí

Documentación de la API

La documentación de la API de HubSpot se divide en dos secciones: documentos de referencia y guías de integración.

Documentos de referencia

Todos los documentos de referencia de la API incluyen una sección de resumen y una sección de puntos finales. El resumen de la API incluye un resumen breve de su funcionalidad, casos de uso y consideraciones especiales para crear una integración. La sección de puntos finales contiene cada punto final, sus parámetros y ejemplos en varios lenguajes.

Una vez que hayas configurado los valores de configuración de autorizaciones de la aplicación en tu cuenta de desarrollador, puedes usar Postman o realizar llamadas de prueba directamente desde una página de referencia de punto final. 

Guías de integración

Si quieres aprender los aspectos básicos de la plataforma de HubSpot o ver un ejemplo antes de realizar la primera llamada a la API, puedes encontrar aplicaciones de muestra y tutoriales, además de información detallada sobre las cuentas de desarrollador, trabajo con OAuth, límites de tasa de API y más en nuestra sección Guías de integración. 

Relacionado: Más información sobre los métodos de autentificación o OAuth.

Anunciar la aplicación

Cuando estés listo para compartir tu aplicación con el mundo y convertirte en partner de aplicaciones, lee nuestros requisitos de anuncio y certificación. Después de eso, puedes crear y administrar tu anuncio en el Mercado de aplicaciones directamente desde tu cuenta de desarrollador.

Asistencia técnica y recursos de la comunidad

Obtén respuestas a tus preguntas, establece contactos y comparte tus opiniones al unirse a foros de la comunidad de desarrolladores de HubSpot y a la comunidad de Slack. Estos foros son un excelente lugar para que tu voz sea escuchada, los comentarios de la comunidad son muy importantes para nosotros y para enriquecer nuestros esfuerzos continuos para mejorar la experiencia del desarrollador de HubSpot.

También puedes mantenerte actualizado con nuevas características, anuncios y cambios importantes suscribiendo al blog Changelog.

Creación del CMS

¿Quieres crear un sitio web, blog, página de destino, aplicación sencilla o un correo electrónico? Consulta nuestros documentos de desarrollador de CMS.

Documentos relacionados

Cómo usar las API de HubSpot