history.get

Опис

integer/array history.get(object parameters)

Метода омогућава преузимање података историје у складу са датим параметрима.

Ова метода може да врати историјске податке избрисаног ентитета ако ове податке није уклонио домаћица.

Ова метода је доступна корисницима било ког типа . Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Userroles за више информација.

Параметри

(object) Параметри који дефинишу жељени излаз.

Метод подржава следеће параметре.

Parameter	Type	Опис
history	integer	Типови објеката историје које треба вратити.<бр><бр> Могуће вредности:<бр>0 - numeric float;<бр>1 - character;<бр>2 - log;<бр>3 - (подразумевано) numeric unsigned;<бр>4 - text;<бр>5 - binary.
hostids	ID/array	Врати само историју са датих домаћинима.
itemids	ID/array	Врати само историју из датих ставки.
time_from	timestamp	Врати само вредности које су примљене после или у датом тренутку.
time_till	timestamp	Врати само вредности које су примљене пре или у датом тренутку.
sortfield	string/array	Сортирај резултат према датим својствима.<бр><бр> Могуће вредности: `itemid`, `clock`, `ns`.
countOutput	boolean	Ови параметри који су заједнички за све методе `get` су детаљно описани у референтном коментару страница.
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
output	query
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Повратне вредности

(integer/array) Враћа било:

низ објеката;
број преузетих објеката, ако је параметар countOutput коришћен.

Примери

Преузимање података историје ставки

Врати 10 последњих вредности примљених од нумеричке (флоат) ставке.

Request:

{
            "jsonrpc": "2.0",
            "method": "history.get",
            "params": {
            "output": "extend",
            "history": 0,
            "itemids": "23296",
            "sortfield": "clock",
            "sortorder": "DESC",
            "limit": 10
            },
            "id": 1
       }

Одговор:

{
            "jsonrpc": "2.0",
            "result": [
            {
            "itemid": "23296",
            "clock": "1351090996",
            "value": "0.085",
            "ns": "563157632"
            },
            {
            "itemid": "23296",
            "clock": "1351090936",
            "value": "0.16",
            "ns": "549216402"
            },
            {
            "itemid": "23296",
            "clock": "1351090876",
            "value": "0.18",
            "ns": "537418114"
            },
            {
           "itemid": "23296",
            "clock": "1351090816",
            "value": "0.21",
            "ns": "522659528"
            },
            {
            "itemid": "23296",
            "clock": "1351090756",
            "value": "0.215",
            "ns": "507809457"
            },
           {
            "itemid": "23296",
            "clock": "1351090696",
            "value": "0.255",
            "ns": "495509699"
            },
            {
            "itemid": "23296",
            "clock": "1351090636",
            "value": "0.36",
            "ns": "477708209"
            },
            {
            "itemid": "23296",
            "clock": "1351090576",
            "value": "0.375",
            "ns": "463251343"
            },
            {
            "itemid": "23296",
            "clock": "1351090516",
            "value": "0.315",
            "ns": "447947017"
            },
            {
            "itemid": "23296",
            "clock": "1351090456",
            "value": "0.275",
            "ns": "435307141"
            }
            ],
            "id": 1
       }

Извор

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

Documentation