trend.get

Beschrijving

integer/array trend.get(object parameters)

De methode maakt het mogelijk om trendgegevens op te halen volgens de gegeven parameters.

Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.

Parameters

(object) Parameters die de gewenste uitvoer definiëren.

De methode ondersteunt de volgende parameters.

Parameter	Type	Beschrijving
itemids	string/array	Retourneer alleen trends met de opgegeven item-ID's.
time_from	timestamp	Retourneer alleen waarden die na of op het opgegeven tijdstip zijn verzameld.
time_till	timestamp	Retourneer alleen waarden die voor of op het opgegeven tijdstip zijn verzameld.
countOutput	boolean	Tel het aantal opgehaalde objecten.
limit	integer	Beperk het aantal opgehaalde objecten.
output	query	Stel velden in op uitvoer.

Retourwaarden

(integer/array) Retourneert ofwel:

een reeks objecten;
het aantal opgehaalde objecten, als de countOutput parameter heeft gebruikt.

Voorbeelden

Item trend gegevens ophalen

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "trend.get",
           "params": {
               "output": [
                   "itemid",
                   "clock",
                   "num",
                   "value_min",
                   "value_avg",
                   "value_max",
               ],
               "itemids": [
                   "23715"
               ],
               "limit": "1"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "23715",
                   "clock": "1446199200",
                   "num": "60",
                   "value_min": "0.165",
                   "value_avg": "0.2168",
                   "value_max": "0.35",
               }
           ],
           "id": 1
       }

Bron

CTrend::get() in ui/include/classes/api/services/CTrend.php.

Documentation