{"id":441544,"date":"2026-04-03T02:43:24","date_gmt":"2026-04-03T00:43:24","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/api-rest-authentification\/"},"modified":"2026-04-23T01:47:50","modified_gmt":"2026-04-22T23:47:50","password":"","slug":"api-rest-authentification","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/fr\/documentation\/api\/api-rest-authentification\/","title":{"rendered":"API REST – Authentification"},"content":{"rendered":"

L’op\u00e9ration de connexion est un processus en deux \u00e9tapes : obtenir un token, puis \u00e9changer les informations d’identification (nom d’utilisateur et cl\u00e9 d’acc\u00e8s).<\/p>\n

Vous pouvez trouver votre cl\u00e9 d’acc\u00e8s sous \u00ab Mes pr\u00e9f\u00e9rences \u00bb dans l’interface web de Kafinea.<\/p>\n

\n

\u00c9tape 1 : Obtenir un token (getchallenge)<\/h2>\n
\n

GET<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n

\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\nDoit \u00eatre getchallenge<\/code><\/td>\n<\/tr>\n
username<\/code><\/td>\nstring<\/td>\noui<\/td>\nNom d’utilisateur Kafinea<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

Exemple curl :<\/strong><\/p>\n

curl "https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php?operation=getchallenge&username=admin"\n<\/code><\/pre>\n
R\u00e9ponse :<\/strong><\/p>\n
{\n  "success": true,\n  "result": {\n    "token": "[TOKENSTRING]",\n    "serverTime": "[TIMESTAMP]",\n    "expireTime": "[TIMESTAMP]"\n  }\n}\n<\/code><\/pre>\n
\n
\u00c9tape 2 : Connexion (login)<\/h2>\n
\n
POST<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n
\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\nDoit \u00eatre login<\/code><\/td>\n<\/tr>\n
username<\/code><\/td>\nstring<\/td>\noui<\/td>\nNom d’utilisateur Kafinea<\/td>\n<\/tr>\n
accessKey<\/code><\/td>\nstring<\/td>\noui<\/td>\nmd5(token + accessKey)<\/code> \u2014 attention : le K est majuscule<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Exemple curl :<\/strong><\/p>\n
curl -X POST https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php \\\n  -d "operation=login" \\\n  -d "username=admin" \\\n  -d "accessKey=YOUR_MD5_HASH"\n<\/code><\/pre>\n
R\u00e9ponse :<\/strong><\/p>\n
{\n  "success": true,\n  "result": {\n    "sessionId": "[STRING]",\n    "userId": "[STRING]",\n    "version": "[STRING]",\n    "kafineaVersion": "[STRING]"\n  }\n}\n<\/code><\/pre>\n
\n
D\u00e9connexion (logout)<\/h2>\n
\n
POST<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n
\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\nDoit \u00eatre logout<\/code><\/td>\n<\/tr>\n
sessionName<\/code><\/td>\nstring<\/td>\noui<\/td>\nIdentifiant de session obtenu au login<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Exemple curl :<\/strong><\/p>\n
curl -X POST https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php \\\n  -d "operation=logout" \\\n  -d "sessionName=YOUR_SESSION_ID"\n<\/code><\/pre>\n
\n
Prolonger la session (extendsession)<\/h2>\n
Si vous devez prolonger la dur\u00e9e de votre session, utilisez cette op\u00e9ration.<\/p>\n
\n
GET<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n
\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\nDoit \u00eatre extendsession<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Exemple curl :<\/strong><\/p>\n
curl "https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php?operation=extendsession"\n<\/code><\/pre>\n
\n
R\u00e9f\u00e9rences associ\u00e9es \ud83d\udd17<\/h2>\n