Overview ​

BIMData API is a tool to interact with your models stored on BIMData’s servers. Once your account on BIMData Connect is created, you can:

  • Create and manage clouds
  • Create and manage projects
  • Upload IFC, DWG, PDF, plan images
  • Request data from clouds, projects, and models

all API features

APIs ​

BIMData API is composed of five APIs:

Model API ​

  • Upload Models
    • IFC (2x3 to 4.3)
    • DWG
    • DXF
    • PDF
    • Point Clouds (las, laz, ply, xyz, e57)
    • plan images (jpg, png)
  • Retrieve and update Model’s data in real-time
  • 3D models throught glTF format

BCF API ​

  • Create BCF
  • Share BCFs with other services
  • Build a complete automated error management flow
  • We implement the BCF 2.1 API defined by BuildingSMART

Collaboration API ​

  • Create clouds and projects
  • Invite users
  • Manage their rights
  • Share models, data and documents

Webhook API ​

  • Get informed in real-time of your projects activities
  • Build automated workflow

Single Sign-On (SSO) API ​

  • Log in on desktop, tablet, mobile
  • Log in all your BIM Services through BIMData Connect: https://connect.bimdata.io
  • Log in through your own SSO (OpenID Connect or SAMLv2)

General Principles ​

BIMData API follows these general principles:

  • All API access is over HTTPS

  • All non-binary data is sent and received as JSON

  • Errors are sent using standard HTTP response codes (400, 401, 403, 404)

  • Actions are indicated by HTTP verbs: GET, POST, PUT, PATCH, DELETE

WARNING

Calls made over plain HTTP will respond a 302, redirecting to the same URL over HTTPS.

The API Endpoint is: https://api.bimdata.io

OpenID Connect ​

BIMData API uses the OpenID Connect protocol (technically very similar to the OAuth2 protocol). Any OpenID library you may find online to help you implement the protocol also works with BIMData API.