[comment]: # ({668456d1-668456d1})
# auditlog.get

[comment]: # ({/668456d1-668456d1})

[comment]: # ({ead39ee8-002826bb})
### Описание

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

Метод позволяет получать записи журнала аудита в соответствии с заданными параметрами.

::: noteclassic
Этот метод доступен только пользователям типа *Super admin*.
Разрешение на вызов метода можно отозвать в настройках роли пользователя.
Дополнительные сведения см. в разделе [User roles](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/ead39ee8-002826bb})

[comment]: # ({66b1aa54-c9891e0d})
### Параметры

`(object)` Параметры, определяющие требуемый результат.

Метод поддерживает следующие параметры.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|auditids|ID/array|Возвращать только журнал аудита с указанными ID.|
|userids|ID/array|Возвращать только журнал аудита, созданный указанными пользователями.|
|time\_from|timestamp|Возвращать только записи журнала аудита, созданные после указанного времени или в указанное время.|
|time\_till|timestamp|Возвращать только записи журнала аудита, созданные до указанного времени или в указанное время.|
|sortfield|string/array|Сортировать результат по указанным свойствам.<br><br>Возможные значения: `auditid`, `userid`, `clock`.|
|countOutput|boolean|Эти параметры описаны в [справочном комментарии](/manual/api/reference_commentary#common-get-method-parameters).|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/66b1aa54-c9891e0d})

[comment]: # ({07ca11ca-7223bab1})
### Возвращаемые значения

`(integer/array)` Возвращает либо:

-   массив объектов;
-   количество полученных объектов, если использовался параметр `countOutput`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({89b81f44-66670b26})
#### Получение журнала аудита

Получить два последних записи журнала аудита.

[Запрос](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "auditlog.get",
    "params": {
        "output": "extend",
        "sortfield": "clock",
        "sortorder": "DESC",
        "limit": 2
    },
    "id": 1
}
```

Ответ:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "auditid": "cksstgfam0001yhdcc41y20q2",
            "userid": "1",
            "username": "Admin",
            "clock": "1629975715",
            "ip": "127.0.0.1",
            "action": "1",
            "resourcetype": "0",
            "resourceid": "0",
            "resource_cuid": "0",
            "resourcename": "Jim",
            "recordsetid": "cksstgfal0000yhdcso67ondl",
            "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}"
        },
        {
            "auditid": "ckssofl0p0001yhdcqxclsg8r",
            "userid": "1",
            "username": "Admin",
            "clock": "1629967278",
            "ip": "127.0.0.1",
            "action": "0",
            "resourcetype": "0",
            "resourceid": "20",
            "resource_cuid": "0",
            "resourcename": "John",
            "recordsetid": "ckssofl0p0000yhdcpxyo1jgo",
            "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}"
        }
    ],
    "id": 1
}
```

[comment]: # ({/89b81f44-66670b26})

[comment]: # ({e2b9a859-e2b9a859})
### Смотрите также

- · [Audit log object](/manual/api/reference/auditlog/object)

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

[comment]: # ({11b31975-11b31975})
### Источник

CAuditLog::get() в *ui/include/classes/api/services/CAuditLog.php*.

[comment]: # ({/11b31975-11b31975})