Comience a usar el Bluebeam Developer Portal

Cuando inicies sesión con tus credenciales de BBID a través de Okta, el portal verificará instantáneamente tu elegibilidad. No se requiere ninguna solicitud manual de incorporación o correo electrónico al equipo de Asociaciones, a menos que seas un desarrollador de software y/o socio.

Requisitos de suscripción

Al iniciar sesión, el portal comprueba que su cuenta cumple con los tres criterios.

• Cuenta BBID válida

• Suscripción activa a Core, Complete o Max

  • El plan Basics no es elegible: los suscriptores de Basics no pueden acceder al Developer Portal porque no pueden realizar la Creación de Proyectos y Sesiones, que son operaciones críticas para la mayoría de las integraciones. Actualice a Core, Complete o Max para obtener acceso.

  • Desarrolladores de software y socios: Si necesita una licencia NFR especial a través de Bluebeam Partnerships, tendrá que solicitar acceso a Bluebeam Developer Portal.

• Región elegible: EE. UU., AU, DE, Reino Unido y SE

Todas las aplicaciones nuevas se crean en el entorno Sandbox por defecto. Sandbox te ofrece un espacio dedicado para construir y probar tu integración de forma segura antes de que llegue a los usuarios finales.

• Las credenciales de Sandbox se mantendrán consistentes a medida que su aplicación se traslade a Producción.

• Cuando se promocione a Producción, los límites de la tasa se ajustarán para ofrecer servicio de asistencia ante las limitaciones de uso del mundo real.

• Las apps permanecen en el Sandbox hasta que solicites explícitamente la aprobación de producción (consulta el Paso 6).

El flujo de creación de aplicaciones ha sido rediseñado. El formulario de creación de aplicaciones muestra solo los campos relevantes para las integraciones de Bluebeam.

Plataforma y regiones

1. Vaya a My Apps y seleccione Creación de aplicación.

2. Seleccionar la instancia de la API que coincida con tu región en la Creación de la aplicación:
   

   • EE. UU.: https://api.bluebeam.com

   • DE: https://api.bluebeamstudio.de

   • Australia: https://api.bluebeamstudio.com.au

   • UK (Reino Unido): https://api.bluebeamstudio.co.uk

   • SE (Suecia): https://api.bluebeamstudio.s

   
   

Campos de formulario de registro

3. Rellena los campos del formulario de registro:

   • Nombre de la aplicación: introduzca hasta 90 caracteres.

   • Descripción: Introduzca hasta 300 caracteres.

   • Región: Seleccione la instancia de la API de Bluebeam para su región.

   • URL(s) de redireccionamiento: Introduzca valores separados por comas o pulse Intro—el portal los organiza en una lista paginada.

   • ¿Haces pruebas con Postman? Para el URI de redireccionamiento, usa https://oauth.pstmn.io/v1/callback. Tu aplicación de producción utilizará un URI diferente.

Notas de autenticación

4. La API de Bluebeam solo ofrece servicio de asistencia para las siguientes opciones para Tipo de concesión:

   • Código de autorización: todas las llamadas a la API utilizan OAuth 2.0; los usuarios otorgan a tu aplicación permisos para actuar en su nombre

   • Token de actualización

5. URI de redireccionamiento: utiliza https://oauth.pstmn.io/v1/callback
   Este URI es específico para hacer llamadas en Postman. Las herramientas de API alternativas o tu aplicación requerirán un URI diferente.

6. Selecciona Creación de aplicación para enviar el formulario.
   Al enviar el formulario, recibirás un correo electrónico de la marca MuleSoft con el asunto: “Registro de aplicación aprobado”. Por favor, ignore el ignore el correo electrónico. Es un efecto secundario no deseado de usar nuestra solución lista para usar.

7. Obtener credenciales. Ahora debería ver su aplicación de reciente creación en la lista (si no la ve, actualice su navegador). Haga clic en cualquier parte de la línea de la aplicación para que se abra la página de detalles donde podrá ver su ID de cliente y su secreto de cliente.
   
   

8. Si utilizas Postman para las pruebas, obtén un token de acceso a través de Postman.

   1. Acceda a Postman a través de su aplicación de escritorio o navegador y Creación una cuenta gratuita.

   2. Aquí tienes un script que puedes importar a Postman. Este script es una colección de todas las llamadas a la API de Bluebeam disponibles. En Postman, ve a Archivo > Importar y suelta el script.

   3. Para obtener un access_token en Postman, Seleccionar la colección Bluebeam API (Creación de scripts x.x.x).

   4. Selecciona la pestaña Authorization para configurar un nuevo token en Postman.
      

      Para obtener más información sobre la autenticación, consulta la Guía de autenticación. La Guía de autenticación incluye referencias a los parámetros de solicitud, conocidos como variables en Postman.
      Puedes configurar un entorno en Postman para crear variables para tu autorización, o puedes rellenar manualmente los valores requeridos.

      Configuración y valores requeridos en Postman:

      • Tipo de autenticación: debe ser OAuth 2.0

      • Tipo de concesión: código de autorización

      • Nombre del token: code

      • Tipo de concesión: código de autorización

      • Se debe habilitar la opción Autorizar mediante el navegador.

      • URL de autenticación: https://api.bluebeam.com/oauth2/authorize

      • URL del token de acceso: https://api.bluebeam.com/oauth2/token

      • ID de cliente: ID de cliente recibido durante el proceso de registro de la aplicación

      • Secreto del cliente: secreto del cliente recibido durante el proceso de registro de la aplicación

      • Alcance: alcances para puntos finales de Studio; el mínimo requerido es offline_access

      • Estado: estado

      • Autenticación del cliente: envía credenciales del cliente en el cuerpo

   5. Desplázate hasta la parte inferior y selecciona Obtener nuevo token de acceso.
   6. Inicia sesión con tu BBID y selecciona Permitir acceso cuando se te solicite. Se te presentará un token que puedes usar en Postman, nuestros documentos de la API o tu propio código.

La tabla de Mis aplicaciones se ha actualizado con columnas adicionales para que pueda ver los detalles clave de la aplicación de un vistazo.

• Nombre: el nombre de tu aplicación de creación

• ID de cliente: el identificador único utilizado en todas las solicitudes de API

• Entorno: el estado actual (Sandbox, Pendiente o Producción).

• Fecha de creación: La fecha en que se creó la aplicación

• Región: La región de la API en la que se creó su aplicación

• Acciones: selecciona para editar, eliminar, ver credenciales o solicitar la aprobación de producción

En la parte inferior de la tabla, ver las páginas anterior y siguiente si se gestionan varias aplicaciones.

Buscar puntos finales

Una nueva barra de Buscar de palabras clave le permite buscar en todos los puntos finales y parámetros sin desplazarse por la referencia completa. Escriba una palabra clave (p. ej., sesiones, marcas) para ir al punto final relevante.

Solicitud de prueba.

Cada punto final de la API incluye ahora un botón de Solicitud de prueba. Selecciónalo para abrir un panel en el navegador donde podrás:

• Relleno los parámetros de consulta y los cuerpos de solicitud

• Ejecutar llamadas a la API en tiempo real directamente desde la documentación

• Vista la respuesta completa en línea

• Cambiar entre lenguajes de programación (Python, cURL y más).

Ya disponibles: los puntos finales de la API de Marcas ya no están en versión beta y están disponibles para todos los desarrolladores. No se requiere acceso adicional.

Una vez que su aplicación esté construida y probada en Sandbox, seleccione Solicitar aprobación de producción en la página de detalles de su aplicación en Mis aplicaciones. Esto abre un correo electrónico predirigido a integrations@bluebeam.com en su cliente de correo electrónico predeterminado.

Debes incluir la siguiente información en el correo electrónico:

Estado de la aplicación después del envío

• El estado de la aplicación cambia a Pendiente una vez que la solicitud de aprobación se envía.

• Tras la aprobación final, tu aplicación se promociona a producción.

• Recibirá un correo electrónico de que su aplicación de integración ha sido aprobada y el estado cambiará a Producción en el Portal.