On this page
trend.get
Opis
integer/array trend.get(object parameters)
Ta metoda umożliwia pobieranie danych trendów zgodnie z podanymi parametrami.
Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w Rolach użytkowników.
Parametry
(object) Parametry definiujące żądane dane wyjściowe.
Metoda obsługuje następujące parametry.
| Parametr | Type | Opis |
|---|---|---|
| itemids | ID/array | Zwracaj tylko trendy dla podanych identyfikatorów pozycji. |
| time_from | timestamp | Zwracaj tylko wartości, które zostały zebrane po podanym czasie lub o podanym czasie. |
| time_till | timestamp | Zwracaj tylko wartości, które zostały zebrane przed podanym czasem lub o podanym czasie. |
| countOutput | boolean | Policz liczbę pobranych obiektów. |
| limit | integer | Ogranicz liczbę pobranych obiektów. |
| output | query | Ustaw właściwości obiektu trendu, które mają zostać zwrócone. |
Zwracane wartości
(integer/array) Zwraca:
- tablicę obiektów;
- liczbę pobranych obiektów, jeśli został użyty parametr
countOutput.
Przykłady
Pobieranie danych trendów pozycji
{
"jsonrpc": "2.0",
"method": "trend.get",
"params": {
"output": [
"itemid",
"clock",
"num",
"value_min",
"value_avg",
"value_max"
],
"itemids": [
"23715"
],
"limit": "1"
},
"id": 1
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": [
{
"itemid": "23715",
"clock": "1446199200",
"num": "60",
"value_min": "0.165",
"value_avg": "0.2168",
"value_max": "0.35"
}
],
"id": 1
}Źródło
CTrend::get() w ui/include/classes/api/services/CTrend.php.