Manu Venugopal, Keith White, Saikat Bhattacharya, Autodesk
The BIM 360 web services simplify collaborative workflows from pre-construction through field management to handover of a construction project. In this session, we will discuss a new area of the BIM 360 API: HQ APIs for unified account administration and data across BIM 360. HQ APIs allow customers to integrate with BIM 360 and extend their construction eco-system to automate workflows, reduce manual data entry and improve data quality.
The HQ API plays a critical role as part of the Forge platform, providing a secure and single point of integration for customer accounts, into their projects, partner companies, user management, and other account level information. We will introduce the basic functionalities of the HQ API and present use cases on how early adopters such as Layton Construction and JE Dunn Construction are leveraging this API to add value to their construction ecosystem. We will also share the latest developments and future direction for the BIM 360 product line and APIs,
8. Key User Roles:
Account Admins, Corporate Developers, and
External 3rd Party Developers
Key HQ API Categories:
• Secure Account Access Control
• Project Creation/Access Control
• Project Profile
• Partner Companies Directory
• Master Member Directory
• Business Unit Data
BIM 360 API | Account-level (HQ) Functionality
Visit: developer.autodesk.com/en/docs/bim360/v1
BIM 360 API | Account-level (HQ) Functionality
9. FORGE - BIM 360 API | Early Adopter
Layton Construction connecting project data from ERP system
to automatically create projects in BIM 360 HQ and keep them
in sync.
“Pushing data directly to BIM 360 HQ from our ERP system means
less manual data entry risks and costs”
- Jeff Metcalf, Director Information Systems/Controller, Layton Construction
FORGE - BIM 360 API | Early Adopter
JE DUNN’s Dunn Dashboard integrates multiple
3rd party systems including BIM 360 into a
cohesive cloud experience
“By integrating multiple systems into Dunn Dashboard, we are able to
provide a unified experience for our users. And Forge platform, Viewer and
BIM 360 API plays a critical part in helping extend the capabilities.”
- Mark Stocks, Director of Information Architecture, JE Dunn Construction
15. API Deep Dive & Demo
Creating Your Forge Account and App
16. Getting Started / API Deep Dive
Autodesk, Inc. Autodesk, Inc.
Creating Your Account (https://developer.autodesk.com)
Getting Started / API Deep Dive
Creating Your App (https://developer.autodesk.com)
Autodesk, Inc. Autodesk, Inc.
17. Getting Started / API Deep Dive
Creating Your App (https://developer.autodesk.com)
Autodesk, Inc. Autodesk, Inc.
Getting Started / Forge BIM360 API Deep Dive
20. • Autodesk Forge Platform (RESTful
API)
• Send Requests to Forge via REST
API
• The Forge Platform processes the
request and returns information to
the via JSON formatted string
Using REST with Forge BIM360 API
Using REST with Forge BIM360 API
• Example Request & Response (FetchAll Partner Companies)
• Request URI after serialization by REST API
• https://developer.api.autodesk.com/hq/v1/accounts/1d70dae8-28b6-4dc0-9407-
ba238da76eb1/companies?limit=20&offset=0
• Header (not shown)
• "Authorization", "Bearer " + Authorization Token
• Base URL
• https://developer.api.autodesk.com/hq/v1
• Endpoint
• /accounts/1d70dae8-28b6-4dc0-9407-ba238da76eb1/companies
• Parameters (varies per endpoint)
• limit=20&offset=0
21. Using REST with Forge BIM360 API
• Example Request & Response (FetchAll Partner Companies)
Response string prior to de-serialization into
using REST API
[{"id":"a13d7e11-4c69-4f32-b105-
d5f7302ea1ce","account_id":"1d70dae8-28b6-
4dc0-9407-ba238da76eb1","name":"AEC
Technology Consultants","trade":"Architecture",
"address_line_1":"12345 Cedar St",
"address_line_2“:null,"city":"Sometown","postal
_code":"123ABC","state_or_province":null,"coun
try": "United States", “phone":null,
"website_url":null, "description":"Making the
best out of any situation","created_at":"2016-
06-09T17:01:39.557Z", "updated_at":"2016-06-
09T17:01:39.949Z", "erp_id":"","tax_id":""}]
BIM 360 API Demo – Sample Integration
24. Creating a Partner Company - Demo
Mapping Your Integration with Forge BIM360 API
25. Creating a User - Demo
Integration with BIM 360 – Things to Consider
• Create a BIM 360 Project when creatinga project in your ecosystem
• Future services are easy to activate if an associated BIM 360 project exists
• Understand and map data connections between your construction ecosystem
and BIM 360 HQ properties
• Focus on data quality
• Enables future analytics and reporting
• e.g. Trade Type for companies or Contract Type for projects
• Consider addition of users strategicallyinBIM 360 HQ
26. Where To Begin
Where to Begin
• Resources
• BIM 360 API Documentation
• https://developer.autodesk.com
• BIM 360 API Forum
• http://forums.autodesk.com/t5/bim-360-api/bd-p/115
• Partner Account/BIM 360 Developer Sandbox
• Next Session
• “Extend BIM360 Docs with Issues Service API”
Galia Traub, Mikako Harada, Autodesk