Platform API

<back to all web services

SaveDimension

Add or update a dimensions details.

Requires Authentication
The following routes are available for this service:
POST/api/dimensions
PUT/api/dimensions/{DimensionId}
SaveDimension Parameters:
NameParameterData TypeRequiredDescription
DimensionbodyDimensionModelYesDetails of the dimension to be added or updated.
DimensionIdpathGuidYesId of the dimension.
DimensionModel Parameters:
NameParameterData TypeRequiredDescription
DimensionIdformGuidNoId of the Dimension itself.
NameformstringNoDimension name.
DescriptionformstringNoDimension description.
ShortNameformstringNoDimension shortened name.
HasTrafficLightForValuesformboolNoTrue if the values for the dimension should have colours associated with them.
HasImageformboolNo
OwnerContactIdformGuidNoOwner Id of the dimension.
RecordStatusformstringNoRecord status of the dimension.
DimensionValuesformList<DimensionValueModel>NoDimension values for this dimension.
ObjectConnectionIdformGuidNoId that links this dimension to an object.
DimensionValueModel Parameters:
NameParameterData TypeRequiredDescription
DimensionValueIdbodyGuidNoId of the dimension value.
DimensionIdbodyGuidNoDimension Id this value is for.
NamebodystringNoName of the dimension value.
DescriptionbodystringNoDescription of the dimension value.
ShortNamebodystringNoShort Name for the dimension value.
TrafficLightIdbodyGuidNoId of the colour associated.
TrafficLightColourbodystringNoColour associated with the dimension value.
ObjectConnectionIdbodyGuidNoId that links this dimension value to an object.
OwnerContactIdbodyGuidNoOwner Id of the dimension value.
RecordStatusbodystringNoRecord status of the dimension value.
SaveDimensionResponse Parameters:
NameParameterData TypeRequiredDescription
DimensionIdqueryGuidNoId of the Dimension created.
ResponseStatusformResponseStatusNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/dimensions HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"Dimension":{"DimensionId":"00000000-0000-0000-0000-000000000000","Name":"String","Description":"String","ShortName":"String","HasTrafficLightForValues":false,"HasImage":false,"OwnerContactId":"00000000-0000-0000-0000-000000000000","RecordStatus":"String","DimensionValues":[{"DimensionValueId":"00000000-0000-0000-0000-000000000000","DimensionId":"00000000-0000-0000-0000-000000000000","Name":"String","Description":"String","ShortName":"String","TrafficLightId":"00000000-0000-0000-0000-000000000000","TrafficLightColour":"String","ObjectConnectionId":"00000000-0000-0000-0000-000000000000","OwnerContactId":"00000000-0000-0000-0000-000000000000","RecordStatus":"String"}],"ObjectConnectionId":"00000000-0000-0000-0000-000000000000"},"DimensionId":"00000000-0000-0000-0000-000000000000"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"DimensionId":"00000000-0000-0000-0000-000000000000","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}