Simple Authentication

POST /api/method/login

Content-Type: application/x-www-form-urlencoded

Params (in body):

• usr (string)

  Username

• pwd (string)

  Password

Example:

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

Returns:

• HTTP Code: 200
• application/json:

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

• Cookie: sid (send this to authenticate future requests). Expires in three days.

    sid=05d8d46aaebff1c87a90f570a3ff1c0f570a3ff1c87a90f56bacd4;
    path=/;
    domain=.{your frappe instance};
    Expires=Sat, 29 Sep 2018 00:59:54 GMT;

Error:

• HTTP Code: 401
• text/html: Wrong password or username.

GET /api/method/logout

Example:

    curl -X GET https://{your frappe instance}/api/method/logout

Returns:

• HTTP Code: 200
• application/json: {}

GET /api/method/frappe.auth.get_logged_user

Get the ID of the currently authenticated user.

Example:

    curl -X GET https://{your frappe instance}/api/method/frappe.auth.get_logged_user

Returns:

• HTTP Code: 200
• application/json:

    {
      "message": "Administrator"
    }

Author: Raffael Meyer (raffael@alyf.de)