Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

GET http://IP-Address:port/prefix/archive/events/alerts/{ENDTIME}/{BEGINTIME} - get alarms from all Axxon domain Serverspozyskaj alarmy ze wszystkich Serwerów Domeny Axxon.

Info
titleNote

The Składnia dla ENDTIME and BEGINTIME syntax is described in Get archive contents sectionoraz BEGINTIME jest opisana w sekcji Pozyskaj zawartość archiwum.


Note
titleAttention!

If Jeśli w zapytaniu ENDTIME < BEGINTIME, wszystkie zdarzenia w odpowiedzi będą sortowane po czasie w porządku rosnącym.

Jeśli ENDTIME > BEGINTIME, zdarzenia będą sortowane w porządku malejącym in the request, then the events in the response will be sorted by time in ascending order.If ENDTIME > BEGINTIME, then the events will be sorted in descending order.

GET http://IP-Address:port/prefix/archive/events/alerts/{HOSTNAME}/{ENDTIME}/{BEGINTIME} - get alarms from a certain Serverpozyskaj alarmy z określonego Serwera.

Tip

{HOSTNAME} - Server name (see Get Server list nazwa Serwera (zobacz: Pozyskaj listę serwerów).

GET http://IP-Address:port/prefix/archive/events/alerts/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} - get alarms from a certain camerapozyskaj alarmy z określonej kamery.

Tip

{VIDEOSOURCEID} - three-component source endpoint ID (see Get list of video sources (cameras)). For instance, trójkomponentowe ID źródłowego punktu końcowego (zobacz: Pozyskaj listę źródeł wideo (kamer)). Przykład: "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".


ParameterParametrRequiredWymaganyDescriptionOpis
limitNoNie

Limit alarmów w odpowiedzi; domyślna wartość to 100The limit of alarms in the response. If not specified, it is equal to 100 by default.

offsetNoNie

Przesunięcie wyświetlonych wyników o określoną ilość wyników w kolejności. Jeśli zapytanie offset=0 zwraca 100 wyników, aby uzyskać więcej wyników, wyślij zapytanie z offset=100The results offset by the specified number. For example, if a query with offset=0 returned 100 results, then in order to get the next results, it is necessary to run a query with offset=100. If the second query returned 250 results, then in order to get the next results, it is necessary to run a query with offset=350, etc.

limit_to_archiveNoNie

Dostępne począwszy od wersji Is available starting with Axxon Next 4.4.1.9150.

If Jeśli limit_to_archive=1, then the response will return the events only from the accessible part of the archive (seeodpowiedź zwróci zdarzenia tylko z dostępnej części archiwum (zobacz: Konfigurowanie ograniczeń dostępu do starszych nagrań).

archiveNoNie

Dostępne począwszy od wersji Is available starting with Axxon Next 4.4.1.9150.

The name of the archive from the request to receive the list of archives (see Get archive contents).

Nazwa archiwum z zapytania w celu uzyskania listy archiwów (zobacz: Pozyskaj zawartość archiwum).

Przykładowe zapytanieSample request:

GET http://127.0.0.1:80/archive/events/alerts/Server1/past/future?limit=50&offset=0

Sample responsePrzykładowa odpowiedź:

Code Block
{
    "events": [
        {
            "type": "alert",
            "id": "2bb7f765-eb57-604d-a38c-d1d26d22e4d9",
            "raisedAt": "20181219T151437.312808",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "ruleAlert",
                "videoDetector"
            ],
            "initiator": "faceAppeared",
            "reaction": {
                "user": "",
                "reactedAt": "20181219T151937.342036",
                "severity": "unclassified"
            },
            "detectorName": "1.Face detection",
            "rectangles": [
                {
                    "index": "47",
                    "left": "0,85343749999999996",
                    "top": "0,37958333333333333",
                    "right": "1",
                    "bottom": "0,58083333333333331"
                }
            ]
        },
        {
            "type": "alert",
            "id": "03c0d49f-5475-684e-a622-2aaeac303508",
            "raisedAt": "20181219T151005.933417",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "ruleAlert",
                "videoDetector"
            ],
            "initiator": "faceAppeared",
            "reaction": {
                "user": "root",
                "reactedAt": "20181219T151013.109256",
                "severity": "alarm"
            },
            "detectorName": "1.Face detection",
            "rectangles": [
                {
                    "index": "9",
                    "left": "0,83406249999999993",
                    "top": "0,36416666666666664",
                    "right": "1",
                    "bottom": "0,58583333333333332"
                }
            ]
        },
        {
            "type": "alert",
            "id": "6d396f93-4acf-c54b-a26e-c1ab178bdb06",
            "raisedAt": "20181219T150911.101417",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "userAlert"
            ],
            "initiator": "root",
            "reaction": {
                "user": "root",
                "reactedAt": "20181219T150916.264631",
                "severity": "alarm"
            },
            "detectorName": "",
            "rectangles": []
        }
    ],
    "more": false
}


ParameterParametrDescriptionOpis
raisedAt

Field raisedAt is not unique so it might be necessary to skip the previously received alarms starting from the search intervalPole raisedAt nie jest unikalne; konieczne może okazać się pominięcie wcześniej pozyskanych alarmów począwszy od interwału wyszukiwania.

reasons

Possible values of the reasons arrayMożliwe wartości tabeli reasons: armed, disarmed, userAlert, ruleAlert, videoDetector, audioDetector, ray.

severity

Possible values of the severity fieldMożliwe wartości pola severity: unclassified, false, notice, warning, alarm.

initiator

Possible values of the initiator field:

Możliwe wartości pola initiator:

  1. Nazwa użytkownika, który zainicjalizował Name of the user initiated the alarm.
  2. Id of the macro (see  makra (zobacz: Using macros) if the alarm is initiated by macro that was started NOT by the detector (even if this macro has already been removed from the configuration).jeśli alarm został zainicjalizowany poprzez makro, które nie zostało uruchomione przez detektor (nawet, jeśli makro już zostało usunięte z konfiguracji).
  3. Typ detektora, który wyzwolił makro, które zainicjalizowało alarm (zobacz: Type of detector that triggered macro that initiated the alarm (see Pozyskaj listę zdarzeń narzędzi detekcji).

...