[comment]: # translation:outdated

[comment]: # ({669b84c5-669b84c5})
# trend.get

[comment]: # ({/669b84c5-669b84c5})

[comment]: # ({8296b8fc-b49a69bd})
### Beschrijving

`integer/array trend.get(object parameters)`

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

::: noteclassic
Deze methode is beschikbaar voor gebruikers van elk type. Toestemmingen om de methode te gebruiken kunnen worden ingetrokken in de gebruikersrolinstellingen. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles) voor meer informatie.
:::

[comment]: # ({/8296b8fc-b49a69bd})

[comment]: # ({ed63cdf3-e33350ec})
### Parameters

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

De methode ondersteunt de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|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.|

[comment]: # ({/ed63cdf3-e33350ec})

[comment]: # ({7223bab1-7223bab1})
### Retourwaarden

`(integer/array)` Retourneert ofwel:

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

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Voorbeelden

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({27c6d8d0-98fd9c3f})
#### Ophalen van trendgegevens van een item

[Verzoek](/manual/api#performing-requests):

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

Antwoord:

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

[comment]: # ({/27c6d8d0-98fd9c3f})

[comment]: # ({852a9753-852a9753})
### Bron

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

[comment]: # ({/852a9753-852a9753})