BimPoint WebApi Client


Introduction

BimPoint services also provide to our clients a full REST WebApi, which can be viewed https://devapi.bim-point.com/ , production version will be hosted at https://api.bim-point.com/ ;  We also provide .NET WebApiClient, which can be downloaded from nuget.org ;

This documentation describes what is required to use our webapi, how to use most required methods using the WebApiClient;

Before using WebAPI

  • Before using BimPoint WebApi, you need to have an account with us and having projects; If you don't have or  you want a demo, please contact us https://www.bim-point.com/contact ;
  • Once you have an account, you should be able to create account and setup permissions, which limit the scope of what can be done via webapi;
  • You can either generate a Refresh Token for your dev team or for third parties ( Recommended)  or you can provide to them a username and password

Connecting to WebApi

In order to connect to webapi, you typically need to know

  • Your company Url
  • The Project Url
  • The  provided RefreshToken Or UserName/ Password
  • The WebApi Url

Getting Token using username / password


The tokenResponse will contain the a refreshtoken, expiration date and also real token

Getting Token using refreshtoken


Searching for IfcItem

The most probable activity you will be doing is searching for an IfcItem; Before being able to search for ifcitems of a project, you need to understand the structure of each ifcitem.

  • A project is made of one or multiple ifc files http://www.buildingsmart-tech.org/specifications/ifc-overview
  • Each Ifc File is made of several Objects with different types, which we call in our application : IfcItem
  • Each IfcItem has common properties such as Id, Label, Name , GlobalId and Type.
  • Each IfcItem has a set of various properties;
  • Each property is characterized by Key, Name,  Category and ValueType
  • In BimPoint, Each IfcItem can have two different kinds of  set of properties
    • READONLY properties ; these are properties extracted from Ifc File and their keys start with "pXXXX", ie p2, p3
    • READWRITE properties; these properties are user properties defined by user in our system; their keys start with "upXXXX" i.e up1, up252

To search in BimPoint application, you need to know the key of each property, category and  their valuetype in order to build your queries

Finding IfcItem Property Categories

Before searching, it is good to know all IfcItem Property categories; they don't change very often so you can cache them in your own database.

Finding IfcItem Properties

Once you know the categories, you can also find the properties of specific category (optional); Getting properties is important as it will allow you to know the key of each of them


Finding IfcItemUserProperty Categories and Properties

Similar to readonly properties and categories, you can also find the user properties and categories

Finding IfcItems

Once  you know properties, categories , user properties and user property categories, finding IfcItem is easy; The Search object provides great flexibility;

Example 1 : Find All With Criteria Include Properties By Categories

Example 2:  Find All With Criteria. Include specifics properties, user properties and calculate Sum of some properties number properties


Practical Info

BpIfcItemSearch

PropertyNote
GlobalIds list of unique identifiers you want to limit the search too
Idslist of unique ids you want to limit the search to; the ids are internal ids generated by our application; this can change whenever the ifc files are reimport
Labelsinternal ids used in the graphical representation in our main applications;
CriteriasList of criterias; all criterias are executed using AND operators
IfcPropertiesOptionAllow you to specific which properties to be included : either you specifically list keys or categories or none of them (which is default)
UserPropertiesOptionAllow you to specific which user properties to be included: either by keys, categories or none
SumUpPropertyKeysIt will calculates the sum of specified keys; only number types
GetCountif you want us to give you the total count , set this value to true
Takehow many row you want back
SkipFrom which number you want the take to start from
SortByExpected a property key
OrderByasc or desc

BpIfcItemSearchCriteriaOperator

BpIfcItemPropertyOptionInclude

IfcItem Types

The list of ifcitem types are per ifc  specification and it can be found here http://www.buildingsmart-tech.org

User Properties Management

If your permissions allow you, you should be able to create user properties for the project; User properties are grouped by Category and SubCategory; Your permission may allow you to only create user properties of specific categories only; SubCategories can be freely defined and they are used mainly to organize displaying in our main application

To create and query user properties, you need to use IfcItemUserPropertyService

Set / Update User Properties Value of IfcItems

User properties of IfcItem ( started with UPxxx) can also be updated via API;  All depends of your permissions; We require the GlobalId as the unique identifier of the each element to be updated;

Update one


Bulk Updates

If you have multiple items to be updated , Bulk is suitable method for you


Contact

If you have any issues using the webapi client, drop an email to devteam@bim-point.com