/api/lookuppoints

Usage

This function is used to bulk-convert point names in the asset.property format to point IDs for use with tools such as the live data API.

Details

DetailValue
GroupAsset
From Server Version2025.0.0
PermissionGuest
MethodsGET or POST
Parameters
ParameterNotesMeaning
pointsString [Required]Semicolon (;) delimited list of point names
formatString (xml)Either 'xml' or 'json'

Examples

Call
http://ardiserver.com/s/sitename/api/lookuppoints?points=Motor.Speed;Motor.Serial
Success (XML)
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <points>
     <point>
         <asset>Motor</asset>
         <assetid>25</asset>
         <property>Speed</property>
         <propertyid>45</property>
         <type>MEASUREMENT</type>
         <min>0</min>
         <max>100</max>
         <units>m/min</units>
         <decimals>1</decimals>
     </point>
     <point>
         <asset>Motor</asset>
         <assetid>25</asset>
         <property>Serial</property>
         <propertyid>46</property>
         <type>TEXT</type>
         <text>AR9482952</text>
     </point>
  </points>
Success (JSON)
[{
	"asset": "Motor",
        "assetid": 25,
        "property": "Speed",
        "propertyid": 45,
        "type": "MEASUREMENT",
        "min": 0,
        "max": 100,
        "units": "m/min",
        "decimals": 1
},
{
        "asset": "Motor",
        "assetid": 25,
        "property": "Speed",
        "propertyid": 46,
        "type": "TEXT",
        "text": "AR9482952",
}]