Authentification simple

La connexion par identifiant et mot de passe renvoie un cookie sid. Les appels suivants le renvoient pour rester authentifiés.

1 min de lectureMis à jour le 5 octobre 2026Source : docs.frappe.io

Connexion

POST /api/method/login attend un corps application/x-www-form-urlencoded avec usr et pwd. L’exemple curl envoie pourtant un JSON :

terminal

curl -X POST https://{your frappe instance}/api/method/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"usr":"Administrator","pwd":"admin"}'

Réponse en cas de succès, HTTP 200, JSON :

json

{
  "home_page": "/desk",
  "full_name": "Administrator",
  "message": "Logged in"
}

Le cookie sid authentifie les requêtes suivantes. La source indique qu’il expire au bout de trois jours. En cas d’échec, HTTP 401 et un corps text/html : mauvais mot de passe ou mauvais identifiant.

Déconnexion

GET /api/method/logout renvoie HTTP 200 et un JSON {}.

Utilisateur courant

GET /api/method/frappe.auth.get_logged_user renvoie l’identifiant de l’utilisateur authentifié, dans message. L’exemple donne "Administrator".

Point d’attention

La page annonce un corps de type formulaire, alors que l’exemple curl déclare application/json. Le cookie sid doit accompagner les requêtes suivantes. Un identifiant ou un mot de passe incorrect répond en 401 HTML, pas en JSON.