[comment]: # translation:outdated

[comment]: # ({0834cf88-0834cf88})
# > Objet Utilisateur

Les objets suivants sont directement liés à l'API `user`.

[comment]: # ({/0834cf88-0834cf88})

[comment]: # ({d932afe8-0ecc45be})
### Utilisateur

L'objet utilisateur a les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#types-de-données)|Description|
|--|--|------|
|userid|string|*(lecture seule)* ID de l'utilisateur.|
|**username**<br>*(obligatoire)*|string|Nom d'utilisateur.|
|**roleid**<br>*(obligatoire)*|string|ID du rôle de l'utilisateur.|
|attempt\_clock|timestamp|*(lecture seule)* Heure de la dernière tentative de connexion infructueuse.|
|attempt\_failed|integer|*(lecture seule)* Nombre récent de tentatives de connexion infructueuses.|
|attempt\_ip|string|*(lecture seule)* Adresse IP d'où provient la dernière tentative de connexion infructueuse.|
|autologin|integer|Activer ou non la connexion automatique.<br><br>Valeurs possibles :<br>0 - *(par défaut)* auto-login désactivé ;<br>1 - auto-login activé.|
|autologout|string|Durée de vie de la session utilisateur. Accepte les secondes et les unités de temps avec suffixe. Si défini sur 0s, la session n'expirera jamais.<br><br>Par défaut : 15m.|
|lang|string|Code de langue de la langue de l'utilisateur, par exemple, `fr_FR`.<br><br>Par défaut : `default` - par défaut du système.|
|name|string|Nom de l'utilisateur.|
|refresh|string|Période de rafraîchissement automatique. Accepte les secondes et les unités de temps avec suffixe.<br><br>Par défaut : 30s.|
|rows\_per\_page|integer|Nombre de lignes d'objet à afficher par page.<br><br>Par défaut : 50.|
|surname|string|Nom de famille de l'utilisateur.|
|theme|string|Thème de l'utilisateur.<br><br>Valeurs possibles :<br>`default` - *(par défaut)* système par défaut ;<br>`blue-theme` - Bleu ;<br>`dark-theme` - Foncé.|
|url|string|URL de la page vers laquelle rediriger l'utilisateur après la connexion.|
|timezone|string|Fuseau horaire de l'utilisateur, par exemple, `Europe/Paris`, `UTC`.<br><br>Par défaut : `default` - défaut système.<br><br>Pour la liste complète des fuseaux horaires pris en charge, veuillez consulter la [Documentation PHP](https://www.php.net/manual/en/timezones.php).|
|**roleid**<br>*(obligatoire)*|string|ID de rôle de l'utilisateur.|
|alias<br>(obsolète)|string|Cette propriété est obsolète, veuillez utiliser `username` à la place.<br>Alias utilisateur.|

Notez que pour certaines méthodes (mise à jour, suppression) la combinaison de paramètres requise/optionnelle est différente.

[comment]: # ({/d932afe8-0ecc45be})

[comment]: # ({1ad487be-1ad487be})
### Média

L'objet média a les propriétés suivantes.

|Propriété|Type|Description|
|--------|----|-----------|
|**mediatypeid**<br>(obligatoire)|string|ID du type de média utilisé par le média.|
|**sendto**<br>(obligatoire)|string/array|Adresse, nom d'utilisateur ou autre identifiant du destinataire.<br><br>Si le [type de média](/fr/manual/api/reference/mediatype/object#type_de_media) est e-mail, les valeurs sont représentées sous forme de tableau. Pour les autres [types de média](/fr/manual/api/reference/mediatype/object#type_de_media), la valeur est représentée par une chaîne.|
|**active**|integer|Indique si le média est activé.<br><br>Valeurs possibles :<br>0 - *(par défaut)* activé ;<br>1 - désactivé.|
|**severity**|integer|Sévérités des déclencheurs pour lesquelles envoyer des notifications.<br><br>Les sévérités sont stockées sous forme binaire, chaque bit représentant la sévérité correspondante. Par exemple, 12 est égal à 1100 en binaire et signifie que les notifications seront envoyées à partir de déclencheurs de sévérités avertissement et moyen.<br><br>Reportez-vous à la [page d'objet déclencheur](/fr/manual/api/reference/trigger/object#declencheur) pour obtenir une liste des sévérités de déclencheurs prises en charge.<br><br>Par défaut : 63|
|**period**|string|Heure à laquelle les notifications peuvent être envoyées sous forme de [période](/fr/manual/appendix/time_period) ou de macros utilisateur séparées par un point-virgule.<br><br>Par défaut : 1-7,00:00-24:00|

[comment]: # ({/1ad487be-1ad487be})
