.. AUTO-GENERATED FILE. DO NOT EDIT.

Validate ElectronJS login and create session
============================================

Summary
-------

- **Source repository:** ``jef-systems/jef-one-backend``
- **Source SHA:** ``3273bbeddc16c50d6dbcbe4d5b15cc30bdcb89d4``
- **Source run id:** ``28958211201``
- **Module:** ``One``
- **Lambda function:** ``jef-one-validate-electronjs-login-and-create-session``
- **HTTP method:** ``POST``
- **Invocation mode:** ``async``
- **Package mode:** ``no-package``
- **API category:** ``One Complex No Package Async POST APIs``
- **API path:** ``/jef-one-validate-electronjs-login-and-create-session``
- **Endpoint URL:** ``https://api.jefoffice.com/jef-one-validate-electronjs-login-and-create-session``
- **Documentation scope:** ``lambda-complex-no-packages``

Async Confirmation Rule
-----------------------

This write API is documented as an async accepted request, not final write success.
Use the corresponding GET API to confirm the final state.

Description
-----------

ElectronJS desktop durable auth login. Resolves domain/entity/application access, writes session parent plus session-payload child, then asynchronously verifies employee credentials.

Payload Example
---------------

.. code-block:: json

   {
     "entity_number": "1000",
     "application_name": "jef-one",
     "employee_number": "10000",
     "password": "pass1234"
   }

Payload Schema
--------------

.. code-block:: json

   {
     "root": {
       "type": "M",
       "required": true,
       "attributes": {
         "session_id": {
           "type": "S",
           "required": false
         },
         "entity_number": {
           "type": "S",
           "required": true
         },
         "application_name": {
           "type": "S",
           "required": true
         },
         "employee_number": {
           "type": "S",
           "required": true
         },
         "password": {
           "type": "S",
           "required": true
         }
       }
     }
   }

Response Schema
---------------

.. code-block:: json

   {
     "root": {
       "type": "M",
       "required": true,
       "attributes": {
         "is_accepted": {
           "type": "BOOL",
           "required": true
         },
         "is_valid": {
           "type": "BOOL",
           "required": true
         },
         "can_continue": {
           "type": "BOOL",
           "required": true
         },
         "session_saved": {
           "type": "BOOL",
           "required": true
         },
         "session_active": {
           "type": "BOOL",
           "required": true
         },
         "is_active": {
           "type": "BOOL",
           "required": true
         },
         "message": {
           "type": "S",
           "required": true
         },
         "operation": {
           "type": "S",
           "required": true
         },
         "status_code": {
           "type": "N",
           "required": true
         },
         "session_id": {
           "type": "S",
           "required": false
         },
         "session_payload_id": {
           "type": "S",
           "required": false
         },
         "domain_id": {
           "type": "S",
           "required": false
         },
         "main_parent_key_name": {
           "type": "S",
           "required": false
         },
         "main_parent_key_value": {
           "type": "S",
           "required": false
         },
         "entity_number": {
           "type": "S",
           "required": false
         },
         "application_name": {
           "type": "S",
           "required": false
         },
         "employee_number": {
           "type": "S",
           "required": false
         },
         "application_credential_id": {
           "type": "S",
           "required": false
         },
         "application_id": {
           "type": "S",
           "required": false
         },
         "entity_id": {
           "type": "S",
           "required": false
         },
         "employee_id": {
           "type": "S",
           "required": false
         },
         "entity_credential_id": {
           "type": "S",
           "required": false
         },
         "display_name": {
           "type": "S",
           "required": false
         },
         "status": {
           "type": "S",
           "required": false
         },
         "expires_at": {
           "type": "S",
           "required": false
         },
         "created": {
           "type": "S",
           "required": false
         },
         "updated": {
           "type": "S",
           "required": false
         },
         "verified_at": {
           "type": "S",
           "required": false
         },
         "failure_code": {
           "type": "S",
           "required": false
         },
         "failure_reason": {
           "type": "S",
           "required": false
         }
       }
     }
   }

Request Payload
---------------

.. code-block:: json

   {
     "entity_number": "1000",
     "application_name": "jef-one",
     "employee_number": "10000",
     "password": "pass1234"
   }

CMD curl
--------

.. code-block:: bat

   curl.exe -X POST "https://api.jefoffice.com/jef-one-validate-electronjs-login-and-create-session" -H "Content-Type: application/json" --data-raw '{}'

PowerShell curl
---------------

.. code-block:: powershell

   curl.exe -X POST "https://api.jefoffice.com/jef-one-validate-electronjs-login-and-create-session" -H "Content-Type: application/json" --data-raw '{}'