Platform API

<back to all web services

GetDimensionsAndValues

Get a list of dimensions and their values (active) for a licensee, as well as any standard dimensions.

Requires Authentication
The following routes are available for this service:
GET/api/dimensions/includevalues
GetDimensionsAndValues Parameters:
NameParameterData TypeRequiredDescription
LicenseeIdqueryGuidNoLicensee Id to retrieve dimensions for.
GetDimensionsListResponse Parameters:
NameParameterData TypeRequiredDescription
DimensionsqueryList<DimensionModel>NoList of dimensions.
ResponseStatusformResponseStatusNo
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.

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.

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

{"Dimensions":[{"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"}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}