The document provides an overview of the BIM 360 Docs Issues API, including a product demo and details on authentication, the data management API, and the issues API. It discusses using the issues API to create, retrieve, update, and link issues to BIM 360 projects and documents. Future capabilities may include bulk updates, associating issues to 3D locations, and expanding beyond BIM 360.

1. Galia Traub
Senior Software Engineer
BIM 360, Autodesk
Extend BIM 360 Docs with the Issues API
Mikako Harada
AEC Technical Lead & Americas Manager
Developer Technical Services, Autodesk

2. Session Goals
• Preview API’s for BIM 360 Docs
• Give overview of API structure and design
• Get ready for the beta

3. Agenda
• BIM 360 Docs - Product Overview
• BIM 360 Docs - API
• Overview
• Data Management API
• Issues API
• Q&A

4. BIM 360 Docs – Product Overview

5. BIM 360 Docs – Product Demo

6. Why BIM 360 Docs?
• Docs as data at center
• Seamless, unified future
DocsHQ
Glue FieldDocsLayout Plan

7. BIM 360 Docs - API

8. BIM 360 Docs – API Overview
• Authentication (OAuth)
• BIM 360 API
(Account/HQ Mgmt)
• Data Management API
• Model Derivative API
• Viewer
• Issues API

9. BIM 360 Docs – API Overview
• Authentication (OAuth)
• BIM 360 API
(Account/HQ Mgmt)
• Data Management API
• Model Derivative API
• Viewer
• Issues API

10. BIM 360 Docs – API Overview
• Authentication (OAuth)
• BIM 360 API
(Account/HQ Mgmt)
• Data Management API
• Model Derivative API
• Viewer
• Issues API

11. BIM 360 Docs – API Overview
• Authentication (OAuth)
• BIM 360 API
(Account/HQ Mgmt)I
• Data Management API
• Model Derivative API
• Viewer
• Issues API

12. BIM 360 Docs – API Overview
• Authentication (OAuth)
• BIM 360 API
(Account/HQ Mgmt)
• Data Management API
• Model Derivative API
• Viewer
• Issues API

13. BIM 360 Docs – API Overview
• Authentication (OAuth)
• BIM 360 API
(Account/HQ Mgmt)
• Data Management API
• Model Derivative API
• Viewer
• Issues API

14. Authentication Methods for BIM 360 Docs
• OAuth2
• 2-legged
• Application-only
• 3-legged
• User context
• Re-direct to accounts.autodesk.com
https://developer.autodesk.com/en/docs/oauth/v2/overview/

15. Data Management API

16. Data Management API – Overview
• Document Management
• Common across Autodesk products
• A360
• Fusion/Life Cycle
• BIM 360 Docs
• Consumer products (Tinker CAD)
• …

17. Data Management API – Service Groups
• Project service
• Data service
• Object storage
service (OSS)
• Schema services
https://developer.autodesk.com/en/docs/data/v2/overview/

18. Data Management API
• JSON API
{json:api}
http://jsonapi.org/format/

19. Data Management API
• Drill down with
Test Harness

20. Learn more: Data Management & Related API
Classes
Time Title Focus
Wednesday
2:25 PM Visual Reporting with Connected Design Data Platform, Viewing
3:55 PM Increasing Supply Chain and Manufacturing Capacity with Forge Manufacturing, partner
Thursday
10:50 AM The Path to Forge Platform, Overview
10:50 AM Cloud PDMDemystified – The Futureof File Management Manufacturing, PLM
1:00 PM Free Your BIMData AEC, Model Derivative
2:05 PM Building Data Centric Applications on Forge Manufacturing, partner
3:35 PM Collaborating with Design Data Platform, DM basics
4:40 PM Free Your Design Data Platform, Model Derivative

21. Issues API

22. Outline
• Product demo
• API Intro
• hello world – GET issues
• JSON API
• Demo
• Future work

23. Issues API in Docs

24. Issue Created
POST https://developer.api.autodesk.com/
issues/v1/containers/:container_id/issues*
*internal for now

25. Issue Created
POST https://developer.api.autodesk.com/
issues/v1/containers/:container_id/issues*
*internal for now

26. Issue Created
POST https://developer.api.autodesk.com/
issues/v1/containers/:container_id/issues
Container lets us map this
issue to a BIM360 Project

27. Issue Created
Lets go find it

28. {json:api}
• Open standard
• Consistency - shared conventions
• Clear & detailed specification
• 50+ Clients & Implementations
• Details: jsonapi.org

29. {json:api}
{
data: […],
meta: { record_count: 186 },
links: {
first: "https…",
last: "https…",
next: "https…"
}
}

30. {json:api}data: [
{
id: "<issue_id>",
type: "issues",
links: {
self: "https …/<issue_id>"
},
attributes: {
title: "Grade of parapet is not to
code",
status: "open"
…
},
}
…

31. {json:api}
{
data: […],
meta: { record_count: 186 },
links: {
first: "https…",
last: "https…",
next: "https…"
}
}

32. Demo

33. issue.status

34. assigned_to & assigned_to_type
• Company
• Role
• Individual User

35. assign & open the issue

36. GET (open, company ) issues
https://developer.api.autodesk.com/issues/v1/co
ntainers/:container_id/issues?
filter[status]=open&
filter[assigned_to_type]=company

37. Paging
https://developer.api.autodesk.com/issues/v1/co
ntainers/:container_id/issues?
filter[status]=open&
filter[assigned_to_type]=company
page[limit]=100&
page[offset]=0

38. Sparse fields
https://developer.api.autodesk.com/issues/v1/co
ntainers/:container_id/issues?
filter[status]=open&
filter[assigned_to_type]=company
page[limit]=100&
page[offset]=0&
fields[issues]=assigned_to

39. Demo

40. Issues Vision
• Provides a toolset to track issues
• Data in the middle approach
• Leverages Forge APIs & BIM 360 Docs’
powerful permissions system

41. Future Capabilities
• Bulk updates for syncing & importing
• Issue creation & updating
• Association to location
• Linking to 3D element
• New Issue types
• Quality Issues
• RFIs
• Beyond BIM 360 (A360 & External)
• What else?

42. Thanks!
Questions?
Contact us at
Galia.Traub@autodesk.com ( @galiat)
Mikako.Harada@autodesk.com
Or come find us at
BIM 360 Tower

43. @AutodeskForge
#ForgeDevCon