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 :
curl "https://apps.kafinea.com/YourKafinea/webservice.php?operation=getchallenge&username=admin"
Réponse :
{
"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 :
curl -X POST https://apps.kafinea.com/YourKafinea/webservice.php \
-d "operation=login" \
-d "username=admin" \
-d "accessKey=YOUR_SHA256_HASH"
Réponse :
{
"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 :
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 |