Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Catalog Service

...


Catalog Service

...


Anchor
createNormgetNormListcreateNorm

...

getNormList

Get the norm list
Deck of Cards
idbimCreateNormbimGetNormList


Type
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: norms/norms 

URLhttps://api-stage.bimplus.net/v2/ norms

Examplehttps://api-stage.bimplus.net/v2/norms

JSON Structure

Name

Mandatory / Optional


Card
labelHTTP Method
 GET


Card
labelDescription
idwill be ignoredstring(guid)The id of the norm. Will be taken from request url.
namemandatorystringNorm name
descriptionoptionalstringNorm description
Card
labelHTTP Method
 POST
Card
labelDescription

Create a new norm.

 Gets the norm list


Card
label
Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorRedGreen
langxml
titleJSONStatus
{
Status:  "name":"DIN 1046",
  "description":"DIN 1046"
}
Card
labelResponse
200 OK


code
Code Block
borderColorGreenRed
langxml
titleStatus
Status: 201 Created
titleJSON
[{
    "id":"ed9fe5ba6de06146-96c0125f-f24dc7eb-977995cc-b06b7ce693850c07d85c4d94",
    "name":"DIN 10461045",
    "description":"DIN 10461045"
}

...

  },
  {
    "id":"0da7bbc8-c63d-d090-c458-1431f78987e0",
    "name":"DIN 17100",
    "description":"DIN 17100"
  }
]



Anchor
getNorm
getNorm

Get the norm details
Deck of Cards
idbimGetNorm

...

Get the norm list
Deck of Cards
idbimGetNormList


Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: /norms norms

URLhttps://api-stage.bimplus.net/v2/ norms/<norm_id>

Examplehttps://api-stage.bimplus.net/v2/norms/6de06146-125f-c7eb-95cc-0c07d85c4d94


Card
labelHTTP Method
 GET


Card
labelDescription
 Gets the norm list Get information about a specified norm


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
[{
    "id":"6de06146-125f-c7eb-95cc-0c07d85c4d94",
    "name":"DIN 1045",
    "description":"DIN 1045"
  },
  {
    "id":"0da7bbc8-c63d-d090-c458-1431f78987e0",
    "name":"DIN 17100",
    "description":"DIN 17100"
  }
]





Anchor
getNormgetCountryListgetNorm
getCountryList

Get the

...

country list
Deck of Cards
idbimGetNormbimGetCountryList


Card
defaulttrue
labelURL / Resource / JSON Structure

Resource:

norms

countries

URLhttps://api-stage.bimplus.net/v2/ norms/<norm_id> countries

ExampleExamplehttps://api-stage.bimplus.net/v2/norms/6de06146-125f-c7eb-95cc-0c07d85c4d94 countries


Card
labelHTTP Method
 GET


Card
labelDescription
 Get information about a specified norm Gets the country list


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
[{
    "id":"6de061462909b0d8-125fc6de-c7eb425d-95cc2303-0c07d85c4d94256336ada04f",
    "name":"DIN 1045Germany",
    "description":"DIN 1045Germany"
}

...

  },
  {
    "id":"b7e10710-94f8-bfdf-72a0-eaa80f3bc57e",
    "name":"Italy",
    "description":"Italy"
  }
]



Anchor
getCountry
getCountry

Get the country details
Deck of Cards
idbimGetCountry


Card

...

Delete the specified norm
Deck of Cards
idbimDeleteNorm
Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: normscountries

URLhttps://api-stage.bimplus.net/v2/ norms countries/<norm<country_id>

Examplehttps://api-stage.bimplus.net/v2/normscountries/6de06146ed9fe5ba-125f96c0-c7ebf24d-95cc9779-0c07d85c4d94 b06b7ce69385


Card
labelHTTP Method
 DELETE GET


Card
labelDescription
Delete the specified norm Get information about a specified country


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK

...


Code Block
borderColorRed
langxml
titleJSON
{
  "id":"ed9fe5ba-96c0-f24d-9779-b06b7ce69385",
  "name":"Austria",
  "description":"Austria"
}




Anchor
getCatalogTypesList
getCatalogTypesList
Get a list of catalog types

...

Deck of Cards
idbimCreateCountrybimGetCatalogTypesList


Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: countriescatalogs/types

URLhttps://api-stage.bimplus.net/v2/ catalogs/ countriestypes

Examplehttps://api-stage.bimplus.net/v2/catalogs/countriestypes

JSON Structure

Name

Mandatory / Optional

Type

Description

idwill be ignoredstring(guid)The id of the country. Will be taken from request url.catalog type.
namemandatorystringCountry Catalog type name
descriptionoptionalstringCountry Catalog type description



Card
labelHTTP Method
 POST GET


Card
labelDescription
Create a new country. Get a list of catalog types


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
langxml
titleJSON
{
  "name":"Austria",
  "description":"Austria"
}



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 201200 CreatedOK


Code Block
borderColorRed
langxml
titleJSON
[{
    "id":"ed9fe5ba992bdb90-96c0e093-f24d4e6d-977982cd-b06b7ce69385d8395ec14496",
    "name":"AustriaMaterial",
    "description":"AustriaMaterial"
  },
  ...
]



Anchor
getCountryListgetCatalogTypegetCountryList
getCatalogType

Get the

...

catalog type details
Deck of Cards
idbimGetCountryListbimGetCatalogType


Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: countriescatalogs/types

URLhttps://api-stage.bimplus.net/v2/ countries/ catalogs/types/<catalogType_id>

Examplehttps://api-stage.bimplus.net/v2/countries/catalogs/types/992bdb90-e093-4e6d-82cd-d8395ec14496


Card
labelHTTP Method
 GET


Card
labelDescription
 Gets the country list Get information about a specified norm


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
[{
    "id":"2909b0d8992bdb90-c6dee093-425d4e6d-230382cd-256336ada04fd8395ec14496",
    "name":"GermanyMaterial",
    "description":"Germany"
  },
  {
    "id":"b7e10710-94f8-bfdf-72a0-eaa80f3bc57e",
    "name":"Italy",
    "description":"Italy"
  }
]

...

Material"
}




Anchor
getCatalogItem
getCatalogItem

Get the catalog item

...

details
Deck of Cards
idbimGetCountrybimGetCatalogItem


Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: countriescatalogitems

URLhttps://api-stage.bimplus.net/v2/ countries catalogitems/<country<catalogitem_id>

Examplehttps://api-stage.bimplus.net/v2/countriescatalogitems/ed9fe5baf15e402a-96c0d29d-f24d023c-9779745d-b06b7ce693852b2f41c58483

Card
labelHTTP Method
 GET
Card
labelDescription
 Get information about a specified country
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
Code Block
borderColorRed
langxml
titleJSON
{
  "id":"ed9fe5ba-96c0-f24d-9779-b06b7ce69385",
  "name":"Austria",
  "description":"Austria"
}

...

Delete the specified country

...

idbimDeleteCountry

...

defaulttrue
labelURL / Resource / JSON Structure

Resource: countries

URLhttps://api-stage.bimplus.net/v2/ countries/<country_id>

...

Card
labelHTTP Method
 DELETE

 

Optional query parameters: Used to refine and reduce the set of returned catalog items

Name

Type

Default value

Description

unitstring metric

When query parameter "unit=imperial" is defined, the API will return free-attribute of catalog item with imperial unit.
e.g. https://api-stage.bimplus.net/v2/catalogitems/d3a532ce-145a-5a91-4bba-a445630b93ca/?unit=imperial

Query unit can be only ?unit=metric or ?unit=imperial.

filterstring

When filter "name=I200" is defined the API will return only of catalog item which Name contains requested sub-string, e.g. https://api-stage.bimplus.net/v2/catalogitems?filter=name=I1

if filter is "name=I1" will be returned all catalog items which Name contains substring "I1".
Like I100 I150, etc.

 


Card
labelHTTP Method
 GET


Card
labelDescription
 Get information about a specified catalog item


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
{
  "catalogId":"2d116846-5f7c-a780-3a82-6dd8150989df",
  "properties":{
    "7f670d2a-6c00-4fb1-0dce-bb4f700ca0f4":"1.2e-05",
    "029ca99d-d590-3f36-60ad-c2f8538b6bf4":"No",
    "9df611ca-c547-e0ab-4595-8a017a383592":210000000000,
    "ca5d193d-c7c8-be57-a244-e7d751a67824":80769200000,
    "ceb34ade-8a26-f9a5-b3ea-f247486a1778":7850,
    "52941ec9-f125-d765-aaca-07c7a3e86997":0.3,
    "efd8c210-8d8e-21e6-987f-8924159f961f":0.15,
    "c905659b-74c8-dd27-7c61-e9722abbf9a3":600,
    "9813d85d-cd87-1db0-a4ce-08a94375ecae":45,
    "633a90c2-a927-faf3-22d4-7a17e4f2b81a":355000000,
    "d450c196-451f-6811-0b47-53c5b81f2cc9":470000000
  },
  "id":"f15e402a-d29d-023c-745d-2b2f41c58483",
  "name":"S 998",
  "description":"test catalog item "
}




Anchor
getCatalogList
getCatalogList

Get the catalog list
Deck of Cards
idbimGetCatalogList


Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs

URLhttps://api-stage.bimplus.net/v2/ catalogs

Examplehttps://api-stage.bimplus.net/v2/catalogs

Card
labelDescription

Delete the specified country

...

labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

...

labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK

...

Get a list of catalog types
Deck of Cards
idbimGetCatalogTypesList
Catalog type description

Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: catalogs/types

URLhttps://api-stage.bimplus.net/v2/ catalogs/types

Examplehttps://api-stage.bimplus.net/v2/catalogs/types

JSON Structure

Name

Mandatory / Optional

Type

Description

idwill be ignoredstring(guid)The id of the catalog type.
namemandatorystringCatalog type name
descriptionoptionalstring


Card
labelHTTP Method
 GET


Card
labelDescription
 Get a list of catalog types Gets the catalog list


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
[{
    "idnorms":"992bdb90-e093-4e6d-82cd-d8395ec14496[{
        "id":"96b6d63f-7d86-2270-5ded-a7868308679b",
        "name":"Material",
EC"
      }
    ],
    "countries":[{
        "descriptionid":"Material"7a286f49-ca3e-f2c9-2555-af6f9713071c",
  },
  ...
]

...

Get the catalog type details

...

idbimGetCatalogType
Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs/types

URLhttps://api-stage.bimplus.net/v2/ catalogs/types/<catalogType_id>

Examplehttps://api-stage.bimplus.net/v2/catalogs/types/992bdb90-e093-4e6d-82cd-d8395ec14496

Card
labelHTTP Method
 GET
Card
labelDescription
 Get information about a specified norm

...

labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

...

labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
Code Block
borderColorRed
langxml
titleJSON
{
  "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
  "name":"Material",
  "description":"Material"
}

...

Create a new catalog item
Resource: catalogitems

URLhttps://api-stage.bimplus.net/v2/ catalogitems

Examplehttps://api-stage.bimplus.net/v2/catalogitems

JSON Structure

Deck of Cards
idbimCreateCatalogItem
Card
defaulttrue
labelURL / Resource / JSON Structure

Name

Mandatory / Optional

Type

Description

idwill be ignoredstring(guid)The id of the catalog item
namemandatorystringCatalog item name
descriptionoptionalstringCatalog item description
catalogIdmandatorystringCatalog id. Newly created catalog item belongs to this catalog
propertiesoptionalobject(dictionary)Object which contains pairs of all parameter values for catalog item.
Value in pair represent attribute value of the attribute with Id specified as key in pair.
diagramoptionalobjectObject which includes data for custom table (sigma-epsilon diagram )
Card
labelHTTP Method
 POST
Card
labelDescription

Create a new catalog item to the specified catalog.

Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
langxml
titleJSON
{
    "catalogId": "ae2122c0-f667-f242-40ee-3e57161e433a      "name":"Standard EN"
      }
    ],
    "catalogType":{
      "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
      "name":"Material",
      "description":"Material"
    },
    "id":"2d116846-5f7c-a780-3a82-6dd8150989df",
    "name":"Steel",
    "description":"Steel"
  },
  {
    "norms":[{
        "id":"96b6d63f-7d86-2270-5ded-a7868308679b",
        "name":"EC"
      }
    ],
    "countries":[{
        "id":"7a286f49-ca3e-f2c9-2555-af6f9713071c",
        "name":"Standard EN"
      }
    ],
    "catalogType":{
      "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
      "name":"Material",
      "description":"Material"
    },
    "id":"ae2122c0-f667-f242-40ee-3e57161e433a",
    "name":"Concrete",
    "propertiesdescription": {"Concrete"
  },
  {
    "7f670d2a-6c00-4fb1-0dce-bb4f700ca0f4": "1e-05",norms":[{
        "id":"029ca99d96b6d63f-d5907d86-3f362270-60ad-c2f8538b6bf4": "No"5ded-a7868308679b",
        "4fd9b113-4e9f-22e5-62ab-eb099fb0836fname": "Bi-linear stress-strain diagram","EC"
      }
  "bb88f378-a30c-de7c-a70b-6522c917bd3f": "slow"  ],
        "71164ead-883b-a610-61d0-c32e8caa5cfa": "Quartzite","countries":[{
        "id"11f347c7:"7a286f49-4ebfca3e-fe22f2c9-52852555-1edeb916c0deaf6f9713071c": 32300000000,
        "ca5d193d-c7c8-be57-a244-e7d751a67824name":"Standard 13458300000,EN"
      }
  "ceb34ade-8a26-f9a5-b3ea-f247486a1778": 2500  ],
     "catalogType":{
   "52941ec9-f125-d765-aaca-07c7a3e86997": 0.2   "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
        "efd8c210-8d8e-21e6-987f-8924159f961f": 0.2,
  "name":"Material",
      "c905659b-74c8-dd27-7c61-e9722abbf9a3": 600,description":"Material"
    },
    "id":"9813d85d2e5f209b-cd8798e4-1db0f731-a4ce9f54-08a94375ecaef9ade4a87587": 45,
        "3f2e236f-5708-2eb7-8715-e2f52a6af34b": 28000000,
        "2a30c3bb-3584-5ea9-599e-497f7a984d1d": 2800000,
  "name":"Aluminium",
      "9b6d72a6-b230-78da-6ed3-79630fc263e7": 1900000,
        "9b6e9387-a6d4-af90-bfd5-196d47e67f64": 0.002,
        "d91470f2-8a8d-f7d2-de56-e61747fbbb27": 0.0035,
        "84bbcf5f-fc3f-19fe-47e3-0e9edbb6961e": 0.00175,
        "ae3aa29d-e553-afe6-5a71-82363dab1636": 0.0035,
        "2f6bcd7f-f3b3-b346-d857-5cd0ca17e31f": 36000000,
        "0e588097-5259-fc18-9e74-122f73bbb4f8": 0,
        "d3535e56-710b-a585-3f79-c984760625b2": 0,
        "9b7d1f57-0872-b143-4d5f-19630077c058": 0.032,
        "a27d570d-b739-6acf-50b1-12c73ba1ce36": 2,
        "aa309ea3-de6d-1274-fc6b-380a14e91ef2": 0.9,
        "5b92e65f-9874-4187-c561-064fb845507d": 0,
        "2cd643c8-f198-aad7-8f99-5f35052b3e7c": 3600000
    },
    "diagram": {
        "columns": [
            { "name": "sig", "type": "Double" },
            { "name": "eps", "type": "Double" },
        ],
        "rows": [
            { "items": [ -4.69565e+08, -0.05 ] },
            { "items": [ -4.6751e+08, -0.045 ] },
            { "items": [ -4.34783e+08, -0.00217391 ] },
            { "items": [ 0, 0 ] }
        ]
    },
    "id": "3ea0079e-7cd9-8ea0-1163-70cef77e7eff",
    "name": "C28/35",
    "description": "(Dutch NEN-EN NA)"
}
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 201 Created
Code Block
titleJSON
{
    "catalogId": "ae2122c0-f667-f242-40ee-3e57161e433a",
    "properties": {
        "7f670d2a-6c00-4fb1-0dce-bb4f700ca0f4": "1e-05",
        "029ca99d-d590-3f36-60ad-c2f8538b6bf4": "No",
        "4fd9b113-4e9f-22e5-62ab-eb099fb0836f": "Bi-linear stress-strain diagram",
        "bb88f378-a30c-de7c-a70b-6522c917bd3f": "slow",
        "71164ead-883b-a610-61d0-c32e8caa5cfa": "Quartzite",
        "11f347c7-4ebf-fe22-5285-1edeb916c0de": 32300000000,
        "ca5d193d-c7c8-be57-a244-e7d751a67824": 13458300000,
        "ceb34ade-8a26-f9a5-b3ea-f247486a1778": 2500,
        "52941ec9-f125-d765-aaca-07c7a3e86997": 0.2,
        "efd8c210-8d8e-21e6-987f-8924159f961f": 0.2,
        "c905659b-74c8-dd27-7c61-e9722abbf9a3": 600,
        "9813d85d-cd87-1db0-a4ce-08a94375ecae": 45,
        "3f2e236f-5708-2eb7-8715-e2f52a6af34b": 28000000,
        "2a30c3bb-3584-5ea9-599e-497f7a984d1d": 2800000,
        "9b6d72a6-b230-78da-6ed3-79630fc263e7": 1900000,
        "9b6e9387-a6d4-af90-bfd5-196d47e67f64": 0.002,
        "d91470f2-8a8d-f7d2-de56-e61747fbbb27": 0.0035,
        "84bbcf5f-fc3f-19fe-47e3-0e9edbb6961e": 0.00175,
        "ae3aa29d-e553-afe6-5a71-82363dab1636": 0.0035,
        "2f6bcd7f-f3b3-b346-d857-5cd0ca17e31f": 36000000,
        "0e588097-5259-fc18-9e74-122f73bbb4f8": 0,
        "d3535e56-710b-a585-3f79-c984760625b2": 0,
        "9b7d1f57-0872-b143-4d5f-19630077c058": 0.032,
        "a27d570d-b739-6acf-50b1-12c73ba1ce36": 2,
        "aa309ea3-de6d-1274-fc6b-380a14e91ef2": 0.9,
        "5b92e65f-9874-4187-c561-064fb845507d": 0,
        "2cd643c8-f198-aad7-8f99-5f35052b3e7c": 3600000
    },
    "diagram": {
        "columns": [
            { "name": "sig", "type": "Double" },
            { "name": "eps", "type": "Double" },
        ],
        "rows": [
            { "items": [ -4.69565e+08, -0.05 ] },
            { "items": [ -4.6751e+08, -0.045 ] },
            { "items": [ -4.34783e+08, -0.00217391 ] },
            { "items": [ 0, 0 ] }
        ]
    },
    "id": "3ea0079e-7cd9-8ea0-1163-70cef77e7eff",
    "name": "C28/35",
    "description": "(Dutch NEN-EN NA)"
}

...

Get the catalog item details

...

idbimGetCatalogItem

...

defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogitems

URLhttps://api-stage.bimplus.net/v2/ catalogitems/<catalogitem_id>

Examplehttps://api-stage.bimplus.net/v2/catalogitems/f15e402a-d29d-023c-745d-2b2f41c58483

Optional query parameters: Used to refine and reduce the set of returned catalog items

...

Name

...

Type

...

Default value

...

Description

...

When query parameter "unit=imperial" is defined, the API will return free-attribute of catalog item with imperial unit.
e.g. https://api-stage.bimplus.net/v2/catalogitems/d3a532ce-145a-5a91-4bba-a445630b93ca/?unit=imperial

Query unit can be only ?unit=metric or ?unit=imperial.

"description":"Aluminium"
  }
]



Anchor
getCatalog
getCatalog

Get the catalog details
Deck of Cards
idbimGetCatalog


Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs

URLhttps://api-stage.bimplus.net/v2/ catalogs/<catalog_id>

Examplehttps://api-stage.bimplus.net/v2/catalogs/ae2122c0-f667-f242-40ee-3e57161e433a


Card
labelHTTP Method
 GET


Card
labelDescription
 Get information about a specified catalog


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

...

When filter "name=I200" is defined the API will return only of catalog item which Name contains requested sub-string, e.g. https://api-stage.bimplus.net/v2/catalogitems?filter=name=I1

if filter is "name=I1" will be returned all catalog items which Name contains substring "I1".
Like I100 I150, etc.

Card
labelHTTP Method
 GET
Card
labelDescription
 Get information about a specified catalog item

...

labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

...

labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
Code Block
borderColorRed
langxml
titleJSON
{
  "catalogId":"2d116846-5f7c-a780-3a82-6dd8150989df",
  "properties":{
    "7f670d2a-6c00-4fb1-0dce-bb4f700ca0f4":"1.2e-05",
    "029ca99d-d590-3f36-60ad-c2f8538b6bf4":"No",
    "9df611ca-c547-e0ab-4595-8a017a383592":210000000000,
    "ca5d193d-c7c8-be57-a244-e7d751a67824":80769200000,
    "ceb34ade-8a26-f9a5-b3ea-f247486a1778":7850,
    "52941ec9-f125-d765-aaca-07c7a3e86997":0.3,
    "efd8c210-8d8e-21e6-987f-8924159f961f":0.15,
    "c905659b-74c8-dd27-7c61-e9722abbf9a3":600,
    "9813d85d-cd87-1db0-a4ce-08a94375ecae":45,
    "633a90c2-a927-faf3-22d4-7a17e4f2b81a":355000000,
    "d450c196-451f-6811-0b47-53c5b81f2cc9":470000000
  },
  "id":"f15e402a-d29d-023c-745d-2b2f41c58483",
  "name":"S 998",
  "description":"test catalog item "
}

...

Create a new catalog

...

idbimCreateCatalog

...

defaulttrue
labelURL / Resource / JSON Structure

...

URLhttps://api-stage.bimplus.net/v2/ catalogs

Examplehttps://api-stage.bimplus.net/v2/catalogs

JSON Structure

...

Name

...

Mandatory / Optional

...

Type

...

Description

...

Card
labelHTTP Method
 POST
Card
labelDescription

Create a new catalog.

...

labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
langxml
titleJSON
{
  "name":"Timber",
  "description":"Timber",
  "catalogtype":{
    "id":"992bdb90-e093-4e6d-82cd-d8395ec14496"
  }
}

...

labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 201 Created
Code Block
titleJSON
{
  "norms":[],
  "countries":[],
  "catalogType":{
    "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
    "name":"Material",
    "description":"Material"
  },
  "id":"10e3f185-234e-9686-5fea-73075149abd2",
  "name":"Timber",
  "description":"Timber"
}

...

Get the catalog list

...

idbimGetCatalogList
Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs

URLhttps://api-stage.bimplus.net/v2/ catalogs

Examplehttps://api-stage.bimplus.net/v2/catalogs

Card
labelHTTP Method
 GET
Card
labelDescription
 Gets the catalog list

...

labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

...

labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
Code Block
borderColorRed
langxml
titleJSON
[{
    "norms":[{
        "id":"96b6d63f-7d86-2270-5ded-a7868308679b",
        "name":"EC"
      }
    ],
    "countries":[{
        "id":"7a286f49-ca3e-f2c9-2555-af6f9713071c",
        "name":"Standard EN"
      }
    ],
    "catalogType":{
      "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
      "name":"Material",
      "description":"Material"
    },
    "id":"2d116846-5f7c-a780-3a82-6dd8150989df",
    "name":"Steel",
    "description":"Steel"
  },
  {
    "norms":[{
        "id":"96b6d63f-7d86-2270-5ded-a7868308679b",
        "name":"EC"
      }
    ],
    "countries":[{
        "id":"7a286f49-ca3e-f2c9-2555-af6f9713071c",
        "name":"Standard EN"
      }
    ],
    "catalogType":{
      "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
      "name":"Material",
      "description":"Material"
    },
    "id":"ae2122c0-f667-f242-40ee-3e57161e433a",
    "name":"Concrete",
    "description":"Concrete"
  },
  {
    "norms":[{
        "id":"96b6d63f-7d86-2270-5ded-a7868308679b",
        "name":"EC"
      }
    ],
    "countries":[{
        "id":"7a286f49-ca3e-f2c9-2555-af6f9713071c",
        "name":"Standard EN"
      }
    ],
    "catalogType":{
      "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
      "name":"Material",
      "description":"Material"
    },
    "id":"2e5f209b-98e4-f731-9f54-f9ade4a87587",
    "name":"Aluminium",
    "description":"Aluminium"
  }
]

...

Get the catalog details

...

idbimGetCatalog
Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs

URLhttps://api-stage.bimplus.net/v2/ catalogs/<catalog_id>

Examplehttps://api-stage.bimplus.net/v2/catalogs/ae2122c0-f667-f242-40ee-3e57161e433a

Card
labelHTTP Method
 GET
Card
labelDescription
 Get information about a specified catalog

...

labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

...

labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
Code Block
borderColorRed
langxml
titleJSON
{
  "norms":[{
      "id":"96b6d63f-7d86-2270-5ded-a7868308679b",
      "name":"EC"
    }
  ],
  "countries":[{
      "id":"7a286f49-ca3e-f2c9-2555-af6f9713071c",
      "name":"Standard EN"
    }
  ],
  "catalogType":{
    "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
    "name":"Material",
    "description":"Material"
  },
  "id":"ae2122c0-f667-f242-40ee-3e57161e433a",
  "name":"Concrete",
  "description":"Concrete"
}

...

Update the specified catalog
Deck of Cards
idbimPutCatalog
Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs

URLhttps://api-stage.bimplus.net/v2/ catalogs/<catalog_id>

Examplehttps://api-stage.bimplus.net/v2/catalogs/ae2122c0-f667-f242-40ee-3e57161e433a

Card
labelHTTP Method
 PUT
Card
labelDescription
 Update the specified catalog.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
borderColorRed
langxml
titleJSON
{
  "norms":[{
      "id":"0da7bbc8-c63d-d090-c458-1431f78987e0",
      "name":"European",
      "description":"European"
    }
  ],
  "countries":[],
  "catalogType":{
    "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
    "name":"Material",
    "description":"Material"
  },
  "name":"Concrete X",
  "description":"Concrete"
}



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
{
  "norms":[{
      "id":"0da7bbc896b6d63f-c63d7d86-d0902270-c4585ded-1431f78987e0a7868308679b",
      "name":"European"EC"
    }
  ],
  "countries":[{
      "descriptionid":"European"
7a286f49-ca3e-f2c9-2555-af6f9713071c",
      }
"name":"Standard EN"
    ],}
  "countries":[ ],
  "catalogType":{
    "id":"992bdb90-e093-4e6d-82cd-d8395ec14496",
    "name":"Material",
    "description":"Material"
  },
  "id":"ae2122c0-f667-f242-40ee-3e57161e433a",
  "name":"Concrete X",
  "description":"Concrete"
}



...

Deck of Cards
idbimGetCatalogItemList


Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs/<catalog_id>/items

URLhttps://api-stage.bimplus.net/v2/ catalogs/<catalog_id>/items

Examplehttps://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items

Optional query parameters: Used to refine and reduce the set of returned catalog items

Name

Type

Default value

Description

codestring

When query parameter "code=DIN 1045" is defined, the API will return from requested catalog only items which are related to code/norm DIN 1045.
Instead of code name can be used also codeId 6de06146-125f-c7eb-95cc-0c07d85c4d94. Query parameter 'code' can be interchanged with query parameter norm.
When are defined both query parameters - code and norm, only code is used in api call.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?code=DIN 1045

To get more precisely specified result set of catalog items, can be combined query parameter for 'norm' or 'code' together with 'country' or 'na' query parameter.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?code=DIN 1045&country=Germany

normstring

When query parameter "norm=DIN 1045" is defined, the API will return from requested catalog only items which are related to code/norm DIN 1045.
Instead of code name can be used also normId 6de06146-125f-c7eb-95cc-0c07d85c4d94. Query parameter 'norm' can be interchanged with query parameter code.
When are defined both query parameters - code and norm, only code is used in api call.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?norm=DIN 1045

To get more precisely specified result set of catalog items, can be combined query parameter for 'norm' or 'code' together with 'country' or 'na' query parameter.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?code=DIN 1045&country=Germany

nastring

When query parameter "na=Germany" is defined, the API will return from requested catalog only items which are related to country Germany.
Instead of country name can be used also country Id 2909b0d8-c6de-425d-2303-256336ada04f. Query parameter 'na' can be interchanged with query parameter 'country'.
When are defined both query parameters - 'na' and 'country', only 'na' parameter is used in api call.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?na=Germany

To get more precisely specified result set of catalog items, can be combined query parameter for 'norm' or 'code' together with 'country' or 'na' query parameter.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?code=DIN 1045&na=Germany

countrystring

When query parameter "country=Germany" is defined, the API will return from requested catalog only items which are related to country Germany.
Instead of country name can be used also country Id 2909b0d8-c6de-425d-2303-256336ada04f. Query parameter 'country' can be interchanged with query parameter 'na'.
When are defined both query parameters - 'na' and 'country', only 'na' parameter is used in api call.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?country=Germany

To get more precisely specified result set of catalog items, can be combined query parameter for 'norm' or 'code' together with 'country' or 'na' query parameter.

e.g. https://api-stage.bimplus.net/v2/catalogs/10e3f185-234e-9686-5fea-73075149abd2/items?code=DIN 1045&country=Germany

filterstring

When filter "name=S 998" is defined the API will return only catalog items which Name contains requested sub-string,
e.g. if filter is "name=S 998" will be returned all catalog items which Name contains substring "S 998".

e.g. https://api-stage.bimplus.net/v2/catalogs/2d116846-5f7c-a780-3a82-6dd8150989df/items?filter=name=S 998

To get more precisely specified result set of catalog items, can be combined query parameter filter (by name) together with 'country' or 'code' query parameter.

e.g. https://api-stage.bimplus.net/v2/catalogs/2d116846-5f7c-a780-3a82-6dd8150989df/items?filter=name=S 998&code=DIN 1045&country=Germany

 



Card
labelHTTP Method
 GET


Card
labelDescription
 Get all catalog items of the catalog


Card
labelRequest


Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json



Card
labelResponse


Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK


Code Block
borderColorRed
langxml
titleJSON
[{
    "catalogId":"10e3f185-234e-9686-5fea-73075149abd2",
    "id":"754da75a-c96d-6d4f-01a9-33a178394ecb",
    "name":"GL 26h",
    "description":"(EN 14080)"
  },
  {
    "catalogId":"10e3f185-234e-9686-5fea-73075149abd2",
    "id":"27d2555d-2245-a84a-7950-a4898077261f",
    "name":"GL 30h",
    "description":"(EN 14080)"
  },
  {
    "catalogId":"10e3f185-234e-9686-5fea-73075149abd2",
    "id":"02ce9b8b-720c-a44c-b115-f45a0de7d965",
    "name":"GL 32c",
    "description":"(EN 14080)"
  },
  {
    "catalogId":"10e3f185-234e-9686-5fea-73075149abd2",
    "id":"0e00c600-8004-6a03-8110-4d38c3dc40aa",
    "name":"GL 24h",
    "description":"(EN 14080)"
  },
  {
    "catalogId":"10e3f185-234e-9686-5fea-73075149abd2",
    "id":"fb3bfbb8-aa6a-64b3-b78e-8950ca107891",
    "name":"GL 28h",
    "description":"(EN 14080)"
  },
  {
    "catalogId":"10e3f185-234e-9686-5fea-73075149abd2",
    "id":"9be0c733fb3bfbb8-243daa6a-2e1c64b3-c79cb78e-7be0a2b6c1a38950ca107891",
    "name":"GL 32h28h",
    "description":"(EN 14080)"
  }
]

...

Delete the specified catalog
Deck of Cards
idbimDeleteCatalog
Card
defaulttrue
labelURL / Resource / JSON Structure

Resource: catalogs

URLhttps://api-stage.bimplus.net/v2/ catalogs/<catalog_id>

Examplehttps://api-stage.bimplus.net/v2/catalogs/ae2122c0-f667-f242-40ee-3e57161e433a

Card
labelHTTP Method
 DELETE
Card
labelDescription

Delete the specified catalog

Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatus
Status: 200 OK
:"(EN 14080)"
  },
  {
    "catalogId":"10e3f185-234e-9686-5fea-73075149abd2",
    "id":"9be0c733-243d-2e1c-c79c-7be0a2b6c1a3",
    "name":"GL 32h",
    "description":"(EN 14080)"
  }
]