Documentation
Table of Contents
user.checkAuthentication
Description
object user.checkAuthentication
Cette m¨¦thode v¨¦rifie et prolonge la session utilisateur.
L'appel de la m¨¦thode user.checkAuthentication prolonge la session utilisateur par d¨¦faut.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ
La m¨¦thode accepte les param¨¨tres suivants.
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Type | Description |
|---|---|---|
| extend | boolean | Valeur par d¨¦faut : "true". D¨¦finir sa valeur sur "false" permet de v¨¦rifier la session sans prolonger sa dur¨¦e de vie. Pris en charge depuis Áú»¢¶Ä²© 4.0. |
| sessionid | string | Identifiant de session utilisateur. |
Valeurs retourn¨¦es
(object) Renvoie un objet contenant des informations sur l'utilisateur.
Exemples
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "user.checkAuthentication",
"params": {
"sessionid": "673b8ba11562a35da902c66cf5c23fa2"
},
"id": 1
}R¨¦ponse :
{
"jsonrpc": "2.0",
"result": {
"userid": "1",
"username": "Admin",
"name": "Áú»¢¶Ä²©",
"surname": "Administrator",
"url": "",
"autologin": "1",
"autologout": "0",
"lang": "ru_RU",
"refresh": "0",
"theme": "default",
"attempt_failed": "0",
"attempt_ip": "127.0.0.1",
"attempt_clock": "1355919038",
"rows_per_page": "50",
"timezone": "Europe/Riga",
"roleid": "3",
"type": 3,
"sessionid": "673b8ba11562a35da902c66cf5c23fa2"
"debug_mode": 0,
"userip": "127.0.0.1",
"gui_access": 0
},
"id": 1
}La r¨¦ponse est similaire ¨¤ la r¨¦ponse ¨¤ l'appel User.login avec le param¨¨tre "userData" d¨¦fini sur vrai (la diff¨¦rence est que les donn¨¦es utilisateur sont r¨¦cup¨¦r¨¦es par identifiant de session et non par nom d'utilisateur/mot de passe) .
Check authentication using authentication token
Check and prolong a user session using the user authentication token, and return additional information about the user.
{
"jsonrpc": "2.0",
"method": "user.checkAuthentication",
"params": {
"sessionid": "673b8ba11562a35da902c66cf5c23fa2"
},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"userid": "1",
"username": "Admin",
"name": "Áú»¢¶Ä²©",
"surname": "Administrator",
"url": "",
"autologin": "1",
"autologout": "0",
"lang": "ru_RU",
"refresh": "0",
"theme": "default",
"attempt_failed": "0",
"attempt_ip": "127.0.0.1",
"attempt_clock": "1355919038",
"rows_per_page": "50",
"timezone": "Europe/Riga",
"roleid": "3",
"userdirectoryid": "0",
"ts_provisioned": "0",
"type": 3,
"userip": "127.0.0.1",
"debug_mode": 0,
"gui_access": "0",
"deprovisioned": false,
"auth_type": 0,
"sessionid": "673b8ba11562a35da902c66cf5c23fa2",
"secret": "0e329b933e46984e49a5c1051ecd0751"
},
"id": 1
}Check authentication using API token
Check a user session using the user API token, and return additional information about the user.
{
"jsonrpc": "2.0",
"method": "user.checkAuthentication",
"params": {
"token": "00aff470e07c12d707e50d98cfe39edef9e6ec349c14728dbdfbc8ddc5ea3eae"
},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"userid": "1",
"username": "Admin",
"name": "Áú»¢¶Ä²©",
"surname": "Administrator",
"url": "",
"autologin": "1",
"autologout": "0",
"lang": "ru_RU",
"refresh": "0",
"theme": "default",
"attempt_failed": "0",
"attempt_ip": "127.0.0.1",
"attempt_clock": "1355919338",
"rows_per_page": "50",
"timezone": "Europe/Riga",
"roleid": "3",
"userdirectoryid": "0",
"ts_provisioned": "0",
"type": 3,
"userip": "127.0.0.1",
"debug_mode": 0,
"gui_access": "1",
"deprovisioned": false,
"auth_type": 0
},
"id": 1
}Source
CUser::checkAuthentication() dans ui/include/classes/api/services/CUser.php.