This is a translation of the original English documentation page. Help us make it better.

trend.get

Beschrijving

integer/array trend.get(object parameters)

Deze methode maakt het mogelijk om trendgegevens op te halen op basis van de opgegeven parameters.

Deze methode is beschikbaar voor gebruikers van elk type. Toestemmingen om de methode te gebruiken kunnen worden ingetrokken in de gebruikersrolinstellingen. Zie Gebruikersrollen 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

Ophalen van trendgegevens van een item

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "trend.get",
           "params": {
               "output": [
                   "itemid",
                   "clock",
                   "num",
                   "value_min",
                   "value_avg",
                   "value_max"
               ],
               "itemids": [
                   "23715"
               ],
               "limit": "1"
           },
           "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.