---
title: API REST – Authentification
description: "L'opération de connexion est un processus en deux étapes : obtenir un token, puis échanger les informations d'identification (nom d'utilisateur et clé d'accès). Vous pouvez trouver votre clé d'accès sous « Mes préférences » dans l'interface web de Kafinea. ---…"
url: "https://www.kafinea.com/fr/documentation/api/api-rest-authentification/"
updated: "2026-11-15"
category: Intégrations / API
---

# API REST – Authentification

L'opération de connexion est un processus en deux étapes : obtenir un token, puis échanger les informations d'identification (nom d'utilisateur et clé d'accès).

Vous pouvez trouver votre clé d'accès sous « Mes préférences » dans l'interface web de Kafinea.

---

## Étape 1 : Obtenir un token (getchallenge)

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

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `operation` | string | oui | Doit être `getchallenge` |
| `username` | string | oui | Nom d'utilisateur Kafinea |

**Exemple curl :**

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

**Réponse :**

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

---

## Étape 2 : Connexion (login)

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

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `operation` | string | oui | Doit être `login` |
| `username` | string | oui | Nom d'utilisateur Kafinea |
| `accessKey` | string | oui | `sha256(token + accessKey)` en hexadécimal (l'empreinte MD5 reste acceptée) – attention : le K est majuscule |

**Exemple curl :**

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

**Réponse :**

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

---

## Déconnexion (logout)

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

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `operation` | string | oui | Doit être `logout` |
| `sessionName` | string | oui | Identifiant de session obtenu au login |

**Exemple curl :**

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

---

## Reprendre la session de l'interface (extendsession)

Un script exécuté dans une page de Kafinea, où l'utilisateur est déjà connecté, obtient une session
 d'API sans clé d'accès : le navigateur transmet son cookie de session et l'opération renvoie un
 `sessionName`, avec les droits de l'utilisateur connecté. Une intégration côté serveur utilise
 `getchallenge` puis `login`.

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

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `operation` | string | oui | Doit être `extendsession` |

---

## Références associées 🔗

- [Introduction API](https://www.kafinea.com/fr/documentation/api/api-rest-introduction/)
- [Référence complète de l'API](https://www.kafinea.com/fr/documentation/api/api-rest-reference-complete/)
