Page History

...

Deck of Cards

id	bimCreateCrossSectionDefinition

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/crosssectiondefinitions

URL: https://api-stage.bimplus.net/v2/ content/crosssectiondefinitions

Example: https://api-stage.bimplus.net/v2/content/crosssectiondefinitions

Optional query parameters

Name

Type

Default value

Description

check

boolean

true

When query parameter "check=true" is defined, the API call will check existence of the cross section definition.
If cross section definition already exists in such case is returned error code 409 conflict. This is default behavior.

When "check=false" this call will not check existence same cross section definition,
in such case new cross section definition will be created.

JSON Structure:

Name	Mandatory / Optional	Type	Description
Id	will be ignored	string(guid)	Cross section definition Id
name	mandatory	string	Cross section definition name
description	optional	string	Short description of the cross section definition
freeAttributesId	optional	JSON Array	List of all free attribute Ids, where are defined all parameters for CSG-contour calculation
csgParameters	mandatory	JSON Array	List of objects which define all rules for calculation contour’s vertex of CSG-geometry. Structure of this objects is described below.

JSON Structure of the object in "csgParameters" attribute :

Name	Mandatory / Optional	Type	Description
pointOrder	mandatory	int	Point order
command	mandatory	string	Command for creation CSG-Geometry contour e.g. "O", "L", "R", ....
xCoordinate	mandatory	string	Contains either direct numerical value of coordinate e.g. "0.0" or formula which can contain simple operations between numerical values and/or attribute values defined by attribute name e.g "(B-B1)/2+B1". Expression may contain mathematical operation: [sin], [cos], [tan], [pi], +, /, -, *
yCoordinate	mandatory	string	description see above in xCoordinate
zCoordinate	optional	string	description see above in xCoordinate

Card

label	HTTP Method

POST

Card

label	Description

Creates a new cross section definition in bimplus database. Cross section definition is defined as contour of CSG-geometry.

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
lang	xml
title	JSON

{
	"name":"IPE",
	"description":"IPE-profil",
	"freeAttributesId":[
		"a51576ae-ecaa-43c0-b00c-1ae5efaae4f0",
		"46065318-8776-4f30-85ff-c7276b094097",
		"ec94c7ee-b810-4012-9e94-cc7ed2a9c4bd",
		"d5e91f99-ff75-4262-b21e-05dea7bff340",
		"df51e064-ee1b-4b5d-bdaa-5b053fd8b8a2"
	],
	"csgParameters":[
		{
			"pointOrder":1,
			"command":"O",
			"xCoordinate":"0.0",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":2,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"D"
		},
		...
	]
}

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 201 Created

Code Block

borderColor	Red
lang	xml
title	JSON

{
	"name":"IPE",
	"description":"IPE-profil",
	"freeAttributesId":["a51576ae-ecaa-43c0-b00c-1ae5efaae4f0",
		"46065318-8776-4f30-85ff-c7276b094097",
		"ec94c7ee-b810-4012-9e94-cc7ed2a9c4bd",
		"d5e91f99-ff75-4262-b21e-05dea7bff340",
		"df51e064-ee1b-4b5d-bdaa-5b053fd8b8a2"
	],
	"csgParameters":[{
			"pointOrder":1,
			"command":"O",
			"xCoordinate":"0.0",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":2,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"D"
		},
		{
			"pointOrder":3,
			"command":"L",
			"xCoordinate":"(B-B1)/2",
			"yCoordinate":"D"
		},
		{
			"pointOrder":4,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":5,
			"command":"L",
			"xCoordinate":"(B-B1)/2",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":6,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":7,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":8,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"T"
		},
		{
			"pointOrder":9,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"T"
		},
		{
			"pointOrder":10,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":11,
			"command":"L",
			"xCoordinate":"(B-B1)/2+B1",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":12,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":13,
			"command":"L",
			"xCoordinate":"(B-B1)/2+B1",
			"yCoordinate":"D"
		},
		{
			"pointOrder":14,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":15,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"D"
		},
		{
			"pointOrder":16,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":17,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"0.0"
		}
	],
	"id":"1b0b4c54-1084-4b7b-8b6b-d0154e44f05a"
}

...

Anchor

	getCrossSectionDefinition
	getCrossSectionDefinition

...

Deck of Cards

id	bimGetAllCrossSectionDefinitions

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/crosssectiondefinitions

URL: https://api-stage.bimplus.net/v2/ content/crosssectiondefinitions

Example: https://api-stage.bimplus.net/v2/content/crosssectiondefinitions

Optional query parameters

Name	Type	Default value	Description
groups	boolean	false	When query parameter "groups=true" is defined, the API function returns only all groups of crosssection definitions. All crosssection definitions are returned only if this parameter is set to false or missing.
norm	string		If query parameters groups is true than can be defined additional query parameters norm. In a such case the api function returns only groups of crosssection definitions for required norm. Eg. when norm=European api returns all 'European' norm groups of crosssection definitions.
types	boolean	false	When query parameter "types=true" is defined, the API function returns only id, name, description attributes of crosssection definition of all crosssection definitions (reduced crosssection definition). Complete crosssection definitions are returned only if this parameter is set to false or missing.

Card

label	HTTP Method

GET

Card

label	Description

Get details about all cross section definitions

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

[ 
{
	"id":"1b0b4c54-1084-4b7b-8b6b-d0154e44f05a"
	"name":"IPE",
	"description":"IPE-profil",
	"freeAttributesId":["a51576ae-ecaa-43c0-b00c-1ae5efaae4f0",
		"46065318-8776-4f30-85ff-c7276b094097",
		"ec94c7ee-b810-4012-9e94-cc7ed2a9c4bd",
		"d5e91f99-ff75-4262-b21e-05dea7bff340",
		"df51e064-ee1b-4b5d-bdaa-5b053fd8b8a2"
	],
	"csgParameters":[{
			"pointOrder":1,
			"command":"O",
			"xCoordinate":"0.0",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":2,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"D"
		},
		{
			"pointOrder":3,
			"command":"L",
			"xCoordinate":"(B-B1)/2",
			"yCoordinate":"D"
		},
		{
			"pointOrder":4,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":5,
			"command":"L",
			"xCoordinate":"(B-B1)/2",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":6,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":7,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":8,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"T"
		},
		{
			"pointOrder":9,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"T"
		},
		{
			"pointOrder":10,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":11,
			"command":"L",
			"xCoordinate":"(B-B1)/2+B1",
			"yCoordinate":"T-D"
		},
		{
			"pointOrder":12,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":13,
			"command":"L",
			"xCoordinate":"(B-B1)/2+B1",
			"yCoordinate":"D"
		},
		{
			"pointOrder":14,
			"command":"R",
			"xCoordinate":"R",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":15,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"D"
		},
		{
			"pointOrder":16,
			"command":"L",
			"xCoordinate":"B",
			"yCoordinate":"0.0"
		},
		{
			"pointOrder":17,
			"command":"L",
			"xCoordinate":"0.0",
			"yCoordinate":"0.0"
		}
	],
},
...
]

...

Deck of Cards

id	bimGetCrossSection

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/crosssections/<cross_section_id>

URL: https://api-stage.bimplus.net/v2/ content/crosssections/<cross_section_id>

Example: https://api-stage.bimplus.net/v2/content/crosssections/bef3f6a2-e869-4282-adab-84114ad672f7

Optional query parameters

Name	Type	Default value	Description
group	string		When "group=Z" is defined the API will return only cross sections which belongs to group with name "Z".
norm	string		If query parameter 'group' is defined can be defined also additional query parameters 'norm'. In a such case the api function returns only cross sections which belongs to group with required name and norm. e.g. https://api-stage.bimplus.net/v2/content/crosssections?grupe=Z&norm=European API will return only cross sections which belongs to group with name "Z" and have a norm 'European'
filter	string		When filter "name=I200" is defined the API will return only cross sections which Name contains requested sub-string, e.g. if filter is "name=I1" will be returned all cross section which Name contains substring "I1". Like I100 I150, etc.When filter "group=Z" is defined the API will return only cross sections which belongs to group with name "Z".
round	boolean	true	When round parameter is defined with value "false", API will return simplified cross section geometry. In such case has all arc segmets radius equal to zero.
NOTE : To get details for cross section or groups of cross sections without known or available cross_section_id is possible to use this call without using cross_section_id, but in such case must be defined requested cross section(s) with filter. When is used filter to define requested cross sections will be returned all cross sections with matching filter pattern. e.g. to get all cross sections which names contains string 'H200' let's use api with filter https://api-stage.bimplus.net/v2/content/crosssections?filter=name=H200 In case you know only cross section name, this name can be used in place of <cross_section_id>. In this case will be returned wanted cross section with required name. If required name was not found will be returned error 404 Not found. e.g.: https://api-stage.bimplus.net/v2/content/crosssections/H200

Card

label	HTTP Method

GET

Card

label	Description

Get details of a specified cross section

Card

label	Request

Code Block

borderColor	Green
lang	xml
title	Headers

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
lang	xml
title	Status

Status: 200 OK

Code Block

borderColor	Red
lang	xml
title	JSON

{
	"name":"IPE-200",
	"description":"parameters IPE-200",
	"id":"bef3f6a2-e869-4282-adab-84114ad672f7"
	"crossSectionParameters":
	[
		{
			"freeAttibId":"a51576ae-ecaa-43c0-b00c-1ae5efaae4f0",
			"value":200
			"name":B
		},
		{
			"freeAttibId":"46065318-8776-4f30-85ff-c7276b094097",
			"value":5.6
			"name":r1
		},
		{
			"freeAttibId":"ec94c7ee-b810-4012-9e94-cc7ed2a9c4bd",
			"value":100,
			"name":s

		},
		{
			"freeAttibId":"d5e91f99-ff75-4262-b21e-05dea7bff340",
			"value":8.5
			"name":t
		},
		{
			"freeAttibId":"df51e064-ee1b-4b5d-bdaa-5b053fd8b8a2",
			"value":12
			"name":h
		}
	],
	"crossSectionCharacteristics":
	[
		{
			"freeAttibId": "f6dccf78-0bb7-4fe7-bd24-a6dee284fcd0",
            "value": 200,
            "name": "Area"
        }
	],
	"shape": 
	[
        {
            "x": 0,
            "y": 0,
            "z": 0
        },
        {
            "x": 200,
            "y": 0,
            "z": 0
        },
        {
            "x": 200,
            "y": 108.5315793,
            "z": 0
        },
        {
            "x": 199.3260249,
            "y": 110.9033885,
            "z": 0
        },
        {
            "x": 197.7059317,
            "y": 112.7599257,
            "z": 0
        },
	...
	]
}

...

Math Editor

Space shortcuts

Page tree

Versions Compared

Old Version 30

New Version 31

Key