[comment]: # translation:outdated

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

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

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

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

La méthode permet de récupérer les enregistrements du journal d’audit selon les paramètres fournis.

::: noteclassic
Cette méthode est disponible uniquement pour le type d’utilisateur *Super admin*.
Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur.
Voir [User roles](/manual/web_interface/frontend_sections/users/user_roles) pour plus d’informations.
:::

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

[comment]: # ({66b1aa54-c9891e0d})
### Paramètres

`(object)` Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|auditids|ID/array|Retourne uniquement le journal d'audit avec les ID indiqués.|
|userids|ID/array|Retourne uniquement le journal d'audit créé par les utilisateurs indiqués.|
|time\_from|timestamp|Retourne uniquement les entrées du journal d'audit qui ont été créées après ou à l'heure indiquée.|
|time\_till|timestamp|Retourne uniquement les entrées du journal d'audit qui ont été créées avant ou à l'heure indiquée.|
|sortfield|string/array|Trie le résultat selon les propriétés indiquées.<br><br>Valeurs possibles : `auditid`, `userid`, `clock`.|
|countOutput|boolean|Ces paramètres sont décrits dans le [commentaire de référence](/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})
### Valeurs de retour

`(integer/array)` Renvoie soit :

-   un tableau d’objets ;
-   le nombre d’objets récupérés, si le paramètre `countOutput` a été utilisé.

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

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

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

[comment]: # ({89b81f44-66670b26})
#### Récupérer le journal d'audit

Récupérez les deux enregistrements les plus récents du journal d'audit.

[Requête](/manual/api#performing-requests):

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

Réponse :

```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})
### Voir également

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

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

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

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

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