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

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

[comment]: # ({65bf5802-b49a69bd})
### Descripció

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

El mètode permet recuperar dades de tendències segons els paràmetres proveïts.

::: noteclassic
Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/65bf5802-b49a69bd})

[comment]: # ({b5a1c003-e33350ec})
### Paràmetres

`(object)` Paràmetres que defineixen la sortida esperada.

El mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|itemids|ID/array|Retorna només tendències amb els ID d'elements donats.|
|time\_from|timestamp|Retorna només els valors recollits després o a l'hora especificada.|
|time\_till|timestamp|Retorna només els valors recollits abans o a l'hora especificada.|
|countOutput|boolean|Compta el nombre d'objectes recuperats.|
|limit|integer|Limita la quantitat d'objectes obtinguts.|
|output|query|Defineix les propietats de l'[objecte tendències](/manual/api/reference/trend/object)  a mostrar.|

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

[comment]: # ({7223bab1-7223bab1})
### Valors de retorn

`(integer/array)` Retorna un d'entre:

-   una taula d'objectes;
-   el recompte d'objectes recuperats, si s'empra el paràmetre `countOutput`.

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

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

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

[comment]: # ({27c6d8d0-98fd9c3f})
#### Recuperar les dades de tendència d'un element

[Petició](/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
}
```

Resposta:

```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})
### Font

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

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