POST api/v1/points/properties

Retrieves properties for a set of pointTags. Not all values of CygNetProperties are supported, the list of supported properties is quite long and therefore not fully enumerated. If you want to request a facility property, the point tag format must be one of the long formats which include the facility service.

CygNet Access Requirements

    CygNet ACS security: BRDGAPI ACCESS 1

    CygNet Bridge API license type: Base

Request Information

URI Parameters

None

Body Parameters

NameDescriptionTypeAdditional information
properties

List of properties to attempt to return, properties for all point tags

Collection of CygNetProperty

Required

pointTags

Point tags for requested properties

Collection of string

Required

Request Formats

application/json, text/json

Sample:
{
  "properties": [
    "Value",
    "Units",
    "Description"
  ],
  "pointTags": [
    "CYGSITE.UIS::ANTIER_GM.ANHEP",
    "CYGSITE.UIS::BRADY_GM.ANHEP"
  ]
}

Response Information

Resource Description

Point properties for a set of pointTags

NameDescriptionTypeAdditional information
results

List of point property result pairs

Collection of PointPropertyResultPairDTO

None

errors

List of point property errors

Collection of PointPropertyErrorPairDTO

None

Response Formats

application/json, text/json

Sample:
{
  "results": [
    {
      "pointTag": "CYGSITE.UIS.00004637:ANTIER_GM_ANHEP:ANTIER_GM.ANHEP",
      "properties": [
        {
          "property": "Value",
          "value": "0.03"
        },
        {
          "property": "Units",
          "value": "%"
        },
        {
          "property": "Description",
          "value": "Heptane"
        }
      ]
    }
  ],
  "errors": [
    {
      "pointTag": "CYGSITE.UIS.00004637:BRADY_GM_ANHEP:BRADY_GM.ANHEP",
      "errors": [
        "Unable to read point config record for 'CYGSITE.UIS.00004637:ANTIER_GM_ANHEP:ANTIER_GM.ANHEP'"
      ]
    }
  ]
}