---
title: API REST – Autenticación
description: "La operación de inicio de sesión es un proceso de dos pasos: obtener un token y luego intercambiar las credenciales (nombre de usuario y clave de acceso). Puede encontrar su clave de acceso en «Mis preferencias» en la interfaz web…"
url: "https://www.kafinea.com/es/documentacion/api/api-rest-autenticacion/"
updated: "2026-04-03"
category: API
---

# API REST – Autenticación

La operación de inicio de sesión es un proceso de dos pasos: obtener un token y luego intercambiar las credenciales (nombre de usuario y clave de acceso).

Puede encontrar su clave de acceso en «Mis preferencias» en la interfaz web de Kafinea.

---

## Paso 1: Obtener un token (getchallenge)

> **GET** `https://apps.kafinea.com/{instance}/webservice.php`

| Parámetro | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `operation` | string | sí | Debe ser `getchallenge` |
| `username` | string | sí | Nombre de usuario de Kafinea |

**Ejemplo curl:**

```bash
curl "https://apps.kafinea.com/YourKafinea/webservice.php?operation=getchallenge&username=admin"
```

**Respuesta:**

```json
{
  "success": true,
  "result": {
    "token": "[TOKENSTRING]",
    "serverTime": "[TIMESTAMP]",
    "expireTime": "[TIMESTAMP]"
  }
}
```

---

## Paso 2: Inicio de sesión (login)

> **POST** `https://apps.kafinea.com/{instance}/webservice.php`

| Parámetro | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `operation` | string | sí | Debe ser `login` |
| `username` | string | sí | Nombre de usuario de Kafinea |
| `accessKey` | string | sí | `md5(token + accessKey)` — atención: la K es mayúscula |

**Ejemplo curl:**

```bash
curl -X POST https://apps.kafinea.com/YourKafinea/webservice.php 
  -d "operation=login" 
  -d "username=admin" 
  -d "accessKey=YOUR_MD5_HASH"
```

**Respuesta:**

```json
{
  "success": true,
  "result": {
    "sessionId": "[STRING]",
    "userId": "[STRING]",
    "version": "[STRING]",
    "kafineaVersion": "[STRING]"
  }
}
```

---

## Cerrar sesión (logout)

> **POST** `https://apps.kafinea.com/{instance}/webservice.php`

| Parámetro | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `operation` | string | sí | Debe ser `logout` |
| `sessionName` | string | sí | ID de sesión obtenido al iniciar sesión |

**Ejemplo curl:**

```bash
curl -X POST https://apps.kafinea.com/YourKafinea/webservice.php 
  -d "operation=logout" 
  -d "sessionName=YOUR_SESSION_ID"
```

---

## Extender sesión (extendsession)

Si necesita prolongar la duración de su sesión, utilice esta operación.

> **GET** `https://apps.kafinea.com/{instance}/webservice.php`

| Parámetro | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `operation` | string | sí | Debe ser `extendsession` |

**Ejemplo curl:**

```bash
curl "https://apps.kafinea.com/YourKafinea/webservice.php?operation=extendsession"
```

---

## Referencias asociadas 🔗

- [Introducción a la API](https://www.kafinea.com/es/documentation/api/api-rest-introduccion/)
- [Operaciones CRUD](https://www.kafinea.com/es/documentation/api/api-rest-operaciones-crud/)