{"id":444426,"date":"2026-04-03T02:43:24","date_gmt":"2026-04-03T00:43:24","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/api-rest-autenticacion\/"},"modified":"2026-04-03T02:43:24","modified_gmt":"2026-04-03T00:43:24","password":"","slug":"api-rest-autenticacion","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/es\/documentation\/api\/api-rest-autenticacion\/","title":{"rendered":"API REST – Autenticaci\u00f3n"},"content":{"rendered":"

La operaci\u00f3n de inicio de sesi\u00f3n es un proceso de dos pasos: obtener un token y luego intercambiar las credenciales (nombre de usuario y clave de acceso).<\/p>\n

Puede encontrar su clave de acceso en \u00abMis preferencias\u00bb en la interfaz web de Kafinea.<\/p>\n

\n

Paso 1: Obtener 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
Par\u00e1metro<\/th>\nTipo<\/th>\nRequerido<\/th>\nDescripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nDebe ser getchallenge<\/code><\/td>\n<\/tr>\n
username<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nNombre de usuario de Kafinea<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

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

curl \"https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php?operation=getchallenge&username=admin\"\n<\/code><\/pre>\n
Respuesta:<\/strong><\/p>\n
{\n  \"success\": true,\n  \"result\": {\n    \"token\": \"[TOKENSTRING]\",\n    \"serverTime\": \"[TIMESTAMP]\",\n    \"expireTime\": \"[TIMESTAMP]\"\n  }\n}\n<\/code><\/pre>\n
\n
Paso 2: Inicio de sesi\u00f3n (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
Par\u00e1metro<\/th>\nTipo<\/th>\nRequerido<\/th>\nDescripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nDebe ser  login<\/code><\/td>\n<\/tr>\n
username<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nNombre de usuario de Kafinea<\/td>\n<\/tr>\n
accessKey<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nmd5(token + accessKey)<\/code>  \u2014 atenci\u00f3n: la K es may\u00fascula<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Ejemplo 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
Respuesta:<\/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
Cerrar sesi\u00f3n (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
Par\u00e1metro<\/th>\nTipo<\/th>\nRequerido<\/th>\nDescripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nDebe ser  logout<\/code><\/td>\n<\/tr>\n
sessionName<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nID de sesi\u00f3n obtenido al iniciar sesi\u00f3n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Ejemplo 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
Extender sesi\u00f3n (extendsession)<\/h2>\n
Si necesita prolongar la duraci\u00f3n de su sesi\u00f3n, utilice esta operaci\u00f3n.<\/p>\n
\n
GET<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n
\n\n\n\n\n\n
Par\u00e1metro<\/th>\nTipo<\/th>\nRequerido<\/th>\nDescripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\ns\u00ed<\/td>\nDebe ser  extendsession<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Ejemplo curl:<\/strong><\/p>\n
curl \"https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php?operation=extendsession\"\n<\/code><\/pre>\n
\n
Referencias asociadas \ud83d\udd17<\/h2>\n